Metafieldにtranslatableフィールド追加
翻訳判定が1行で完結
API 2026-10以降、メタフィールドの翻訳可否をオブジェクト自身から直接読み取れるようになりました
このアップデートはGraphQL Admin APIでメタフィールドの翻訳機能を利用しているアプリ開発者が対象です。2026-10以降のAPIバージョンにアップグレードすると、Metafieldオブジェクト上のtranslatable: Boolean!フィールドを参照するだけで翻訳可否を判断できます。非推奨となったTranslatableResourceType.METAFIELDへの依存を解消するための移行が推奨されます。
1変更内容 — Before / After
従来は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への移行ガイド」が提供されている(元記事リンク参照) |
- アプリ内で
translatableResourcesにresourceType: METAFIELDを渡しているクエリを検索する - 対象クエリを
Metafieldオブジェクト上のtranslatableフィールド参照に書き換える - 開発ストアでAPIバージョン2026-10を使って動作確認する
-
TranslatableResourceType.METAFIELDを使うクエリがアプリ内に残っていないことを確認する - UIが
metafield.translatableの値に基づいて翻訳表示を制御していることを確認する
API 2026-10への移行と同時にMetafield.translatableフィールドを活用することで、翻訳可否の判定ロジックをプラットフォームに委ね、アプリの保守コストを大幅に削減できます。
Source: https://shopify.dev/changelog/is-translatable-metafield-field | 公開日: 2026年9月21日






Share:
Shopifyアプリ価格設定:プライベートプラン上限が撤廃
automaticDiscountsクエリ廃止と移行ガイド