GraphQL Admin API

Metafieldにtranslatableフィールド追加
翻訳判定が1行で完結

API 2026-10以降、メタフィールドの翻訳可否をオブジェクト自身から直接読み取れるようになりました

Metafield Objecttype: String!value: String!translatable: Boolean! 🆕TranslatableResourceType.METAFIELD⚠ Deprecated代替

このアップデートはGraphQL Admin APIでメタフィールドの翻訳機能を利用しているアプリ開発者が対象です。2026-10以降のAPIバージョンにアップグレードすると、Metafieldオブジェクト上のtranslatable: Boolean!フィールドを参照するだけで翻訳可否を判断できます。非推奨となったTranslatableResourceType.METAFIELDへの依存を解消するための移行が推奨されます。

1変更内容 — Before / After

Before (〜2026-07)translatableResources( resourceType: METAFIELD) { translatableContent { key value locale }}別クエリで取得 → アプリ側でロジック管理After (2026-10〜)product(id: "...") { metafield( namespace: "custom" key: "care_guide" ) { type translatable # true }}Metafield取得と同時に翻訳可否を確認

従来はtranslatableResourcesクエリを別途呼び出してメタフィールドの翻訳可否を判断していました。2026-10以降はMetafieldオブジェクト自身のtranslatableフィールドを読むだけで済みます。プラットフォームの判定ロジックをアプリ側で複製・維持する必要がなくなります。

2業務に活かせるユースケース

課題
多言語展開する際、どのメタフィールドが翻訳対象かをアプリ側のリストで管理していたが、Shopify側のルール変更のたびに同期作業が発生していた
打ち手
2026-10へ移行後、商品メタフィールド一覧取得クエリにtranslatableフィールドを追加し、trueのものだけ翻訳UIに表示する実装に切り替える
効果
プラットフォームの翻訳可否ルールが変更されても自動的に追従し、アプリ側のロジック保守コストをゼロにできる
技術メモ
translatableはプラットフォーム自身の判定述語から解決されるため、アプリが独自ルールを持つ必要がない
課題
翻訳管理アプリにおいて、翻訳不可のメタフィールドをUIに誤表示してしまい、運用担当者が翻訳できないフィールドを入力しようとするUXの問題があった
打ち手
メタフィールド取得時にtranslatable: falseのものはUI上でグレーアウト表示し、翻訳入力欄を非表示にする条件分岐をmetafield.translatableの値で制御する
効果
翻訳できないフィールドへの誤入力を防ぎ、オペレーションミスと問い合わせ対応コストを削減できる
技術メモ
フィールドはBoolean!(Non-null)のためnullチェック不要。値はtrueかfalseのみ
課題
コンテンツ翻訳のバッチ処理で、翻訳不要なメタフィールドも含めてAPIに送信してしまい、不要なAPI呼び出しとレート制限消費が発生していた
打ち手
バッチ処理の前処理ステップでtranslatable: trueのメタフィールドのみをフィルタリングし、翻訳送信対象リストを生成する
効果
不要なAPI呼び出しを削減してレート制限の消費を最適化し、処理速度と安定性を向上させる
技術メモ
バッチ取得時はGraphQLのフラグメントにtranslatableを含めることで効率的に一括取得できる

3技術者向けポイント

観点 詳細
対象APIバージョン 2026-10以降。2026-07以前ではtranslatableフィールドは存在しない
フィールド型 translatable: Boolean!(Non-null)。nullableではないため安全に参照可能
アクセススコープ 追加のアクセススコープは不要。APIバージョンの切り替えのみで利用可能
移行が必要なケース translatableResourcesクエリでTranslatableResourceType.METAFIELDを使用しているアプリ
移行不要なケース 翻訳可否に関係なくメタフィールド値を読み取るだけのアプリ、2026-07以前を使い続けるアプリ
Deprecation状況 TranslatableResourceType.METAFIELDは2026-07以前では引き続き使用可能だが非推奨扱い
移行ガイド 公式ドキュメントに「TranslatableResourceType.METAFIELDからMetafield.translatableへの移行ガイド」が提供されている(元記事リンク参照)
移行チェックリスト
  1. アプリ内でtranslatableResourcesにresourceType: METAFIELDを渡しているクエリを検索する
  2. 対象クエリをMetafieldオブジェクト上のtranslatableフィールド参照に書き換える
  3. 開発ストアでAPIバージョン2026-10を使って動作確認する
  4. TranslatableResourceType.METAFIELDを使うクエリがアプリ内に残っていないことを確認する
  5. UIがmetafield.translatableの値に基づいて翻訳表示を制御していることを確認する

API 2026-10への移行と同時にMetafield.translatableフィールドを活用することで、翻訳可否の判定ロジックをプラットフォームに委ね、アプリの保守コストを大幅に削減できます。

Source: https://shopify.dev/changelog/is-translatable-metafield-field | 公開日: 2026年9月21日