3月 05, 2026

Asset APIの承認範囲に関する今後の変更点

3月 05, 2026

Asset APIの承認範囲に対する今後の変更

ShopifyのAsset APIに関する重要な変更が予定されています。これは、特に公開アプリを使用してテーマをカスタマイズしている開発者にとって、大きな影響を及ぼす可能性があります。

現状の技術スタックと問題分析

一年以上前に、ShopifyはTheme App Extensionsを公開アプリがテーマに統合する推奨方法として導入しました。これにより、Asset APIの使用が不要になり、より効率的かつ安全な方法でオンラインストアのテーマをカスタマイズすることが可能になりました。

しかし、2023年4月のAdmin APIのリリース候補、またはそれ以降のバージョンをリクエストするとき、Asset APIへのアクセスが公開アプリには制限され、アセットの作成、更新、削除が不可能になることが発表されました。

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

この変更に対応するためには、Asset APIではなくTheme App Extensionsを使用してテーマのカスタマイズを行うことが推奨されています。具体的な移行方法についてはこちらのガイドを参照してください。

実装手順とコード例

Theme App Extensionsを使用したテーマのカスタマイズは、以下のステップで実行できます。

まず、Shopify管理画面から「オンラインストア」->「テーマ」を選択します。
対象のテーマを選択し、「カスタマイズ」をクリックします。
「テーマ設定」を選択し、Theme App Extensionsを有効化します。
Extensionの設定を行い、保存します。

コードを使用して設定を行う場合は、以下のような形式で記述できます。

async function enableThemeAppExtensions(theme) {
  const response = await fetch(`/admin/api/2023_04/themes/${theme.id}/app_extensions.json`, {
    method: 'PUT',
    body: JSON.stringify({
      app_extension: {
        id: 'your-extension-id',
        enabled: true
      }
    })
  });

  return response.json();
}