2月 21, 2026

`MediaImage.originalSource` GraphQLフィールドで`url`が利用可能に

2月 21, 2026

GraphQLフィールド`MediaImage.originalSource`に`url`が利用可能に

Shopify APIのバージョン2023-10より、GraphQL MediaImageのoriginalSourceフィールドにurlフィールドが追加されました。この変更により、アップロードされた非圧縮のオリジナル画像へのアクセスが可能になります。ただし、URLは一定期間のみ有効な署名付きURLとなります。

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

これまでShopifyのGraphQL APIでは、オリジナルの非圧縮画像へ直接アクセスすることができず、そのために高品質な画像を利用したい場合には制限がありました。また、画像へのアクセスには署名付きのURLが必要で、これが一定期間のみ有効となるため、画像の取得・管理には注意が必要です。

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

新たに追加されたurlフィールドを使用することで、オリジナルの非圧縮画像にアクセスできます。これにより、画像の品質を損なうことなく、より高品質な画像を利用することが可能になります。

実装手順とコード例


// GraphQLクエリ例
{
  product(id: "gid://shopify/Product/1234567890") {
    media {
      edges {
        node {
          ... on MediaImage {
            originalSource {
              url
            }
          }
        }
      }
    }
  }
}

上記のGraphQLクエリを実行することで、指定した商品のオリジナル非圧縮画像のURLを取得することができます。