2月 21, 2026

アプリ所有のメタフィールドに対する明示的なアクセス許可の導入

2月 21, 2026

アプリ所有のメタフィールドへの明示的なアクセス許可の導入

ShopifyのGraphQL Admin APIの2023-10バージョンにあたり、新たにgrantsプロパティを使用して、特定のアプリに対してメタフィールドへのREADまたはREAD_WRITEのアクセスを明示的に許可することが可能になりました。

技術的課題の定義と現状分析

これまでのShopifyでは、メタフィールドへのアクセス制御は一律的であり、特定のアプリに対して細かいアクセス制御を行うことが難しかったです。この問題を解決するために新たに導入されたのが、grantsプロパティを使用した明示的なアクセス許可です。

具体的な技術的ソリューションの提案

新たに導入されたgrantsプロパティを使用することで、metafieldDefinitionCreateおよびmetafieldDefinitionUpdateの突然変異において、特定のアプリに対してメタフィールドへのアクセスを明示的に許可することが可能になります。許可レベルと許可対象のアプリは、最大で16個まで一つの定義にリストとして持つことができます。

実装手順とコード例

まず、metafieldDefinitionCreateの突然変異を作成する際に、grantsプロパティを使用して許可対象のアプリと許可レベルを指定します。例えば、アプリIDが1234のアプリに対してREADアクセスを許可する場合は以下のようになります。


mutation {
  metafieldDefinitionCreate(definition: {
    namespace: "my_namespace"
    key: "my_key"
    type: "STRING"
    access: {
      grants: [
        {
          grantee: { app: { id: "gid://shopify/App/1234" } }
          access: READ
        }
      ]
    }
  }) {
    userErrors {
      field
      message
    }
    metafieldDefinition {
      id
    }
  }
}