2月 21, 2026

GraphQL管理ファイルのクエリに3Dモデルと外部ビデオが含まれています

2月 21, 2026

GraphQL管理者向けファイル問い合わせに3Dモデルと外部ビデオが追加されました

ShopifyのGraphQL管理者向けAPIが大きな進歩を遂げました。2024年7月のバージョンリリースから、3Dモデルと外部ビデオがGraphQL管理者向けファイル問い合わせに含まれるようになりました。これは、ECサイトのリッチコンテンツの扱いを一段と容易にする大きなステップです。

技術的課題と現状分析

これまでのECサイト開発では、3Dモデルや外部ビデオなどのリッチコンテンツの取り扱いは、APIを通じて直接アクセスすることが難しく、その結果、リッチコンテンツの活用が制限されていました。しかし、今回のバージョンアップにより、これらのコンテンツをGraphQLを通じて直接問い合わせ、取得できるようになりました。

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

新たに3Dモデルと外部ビデオがGraphQL管理者向けファイル問い合わせに含まれるようになったことで、これらのリッチコンテンツをより簡単に取り扱うことが可能になりました。商品ページなどに3Dモデルや外部ビデオを活用することで、より魅力的なユーザー体験を提供することが可能になります。

実装手順とコード例


// GraphQL管理者向けファイル問い合わせの例
{
  files(first: 5) {
    edges {
      node {
        id
        url
        fileType
        ... on ExternalVideo {
          originalSourceUrl
        }
        ... on Model3d {
          originalSourceUrl
        }
      }
    }
  }
}

上記のコード例では、GraphQL管理者向けファイル問い合わせを使用して、最初の5つのファイル（3Dモデルや外部ビデオを含む）を取得しています。取得した各ファイルのID、URL、ファイルタイプ、外部ビデオや3Dモデルの場合のオリジナルソースURLを取得できます。