【Shopify最新ニュース2026・開発者向け】Global Catalog REST API が11月2日に停止

2026年10月10日

開発者向けの変更です。

Global Catalog REST API が、2026年11月2日に止まります。

掲載は2026年10月9日、開発者向けの Changelog。

出典: Shopify developer changelog「Global Catalog REST API stops serving traffic on November 2, 2026」2026年10月9日
https://shopify.dev/changelog/global-catalog-rest-api-stops-serving-traffic-on-november-2-2026

Flags: Deprecation announcement
Surfaces: Catalog
期限: 2026年11月2日

Global Catalog REST API は、2026年11月2日に止まります

非推奨になったのは2026年4月。

The Global Catalog REST API, which was deprecated in April 2026, stops serving traffic on November 2, 2026. If your app still calls it, you need to migrate to Global Catalog MCP, which implements the Universal Commerce Protocol (UCP), before that date.
（2026年4月に非推奨になった Global Catalog REST API は、2026年11月2日にトラフィックの受け付けを止めます。アプリがまだ呼んでいる場合は、その日までに Universal Commerce Protocol（UCP）を実装した Global Catalog MCP へ移る必要があります）

非推奨: 2026年4月
停止: 2026年11月2日
移行先: Global Catalog MCP
期限: 停止の日より前

In April 2026, we deprecated the Global Catalog REST API and replaced it with Global Catalog MCP.
（2026年4月に、Global Catalog REST API を非推奨にし、Global Catalog MCP に置き換えました）

止まるのは、discover.shopifyapps.com/global/… へのすべてのリクエストです

対象は discover.shopifyapps.com/global/... へのリクエストです。

停止の後は、すべて失敗します。

保存したカタログへのリクエストも対象。
原文は including requests against saved catalogs と書きます。

GET /global/v2/search
GET /global/v2/p/{upid}
GET /global/v2/p/by-variant/{vid}
POST /global/v2/lookup

移行先は Global Catalog MCP です

送り先は catalog.shopify.com/api/ucp/mcp。

使えるツールは3つです。

search_catalog: Search for products across all Shopify merchants, with filters, pagination, and buyer context.
lookup_catalog: Look up products or variants by identifier in batches, up to 50 per request.
get_product: Get full product details with variant selection and availability signals.
（search_catalog: すべての Shopify のマーチャントをまたいで商品を検索します。絞り込み、ページ送り、買い手の文脈を指定できます／lookup_catalog: 識別子で商品やバリエーションをまとめて引きます。1回のリクエストで最大50件です／get_product: バリエーションの選択と在庫状況の手がかりを含む、商品の詳細をすべて取得します）

search_catalog: 商品の検索
lookup_catalog: 識別子でまとめて引く
get_product: 1つの商品の詳細

呼び出しごとに、移る先のツールが決まっています

対応は次のとおり。

REST の呼び出し	移る先
`/global/v2/search`	`search_catalog`
`/global/v2/p/{upid}`	`get_product` に `gid://shopify/p/{upid}` を渡す
`/global/v2/p/by-variant/{vid}`	`get_product` に `gid://shopify/ProductVariant/{id}` を渡す
`/global/v2/lookup`	`lookup_catalog`

ツールの置き換えのほかに、やることが3つあります。

Include meta.ucp-agent.profile with your agent profile URL in every request.
If you query a saved catalog, pass its ID as catalog.catalog_id instead of using a saved-catalog endpoint URL.
Update your app to the UCP catalog request and response schemas.
（すべてのリクエストに、agent profile の URL を入れた meta.ucp-agent.profile を含めます／保存したカタログを問い合わせる場合は、保存したカタログのエンドポイントの URL を使う代わりに、その ID を catalog.catalog_id として渡します／アプリを UCP のカタログのリクエストと応答のスキーマに合わせます）

すべてのリクエストに meta.ucp-agent.profile
保存したカタログは catalog.catalog_id で ID を渡す
リクエストと応答の形は、UCP のカタログのスキーマに合わせる

認証は変わりません

bearer トークンは、これまでどおり Dev Dashboard のクライアントの認証情報から作れます。

Authentication doesn’t change. You can keep generating bearer tokens from your Dev Dashboard client credentials. To try the tools before you migrate, use the Shopify AI Toolkit or run ucp catalog search with the UCP CLI.
（認証は変わりません。Dev Dashboard のクライアントの認証情報から、これまでどおり bearer トークンを作れます。移行の前にツールを試すには、Shopify AI Toolkit を使うか、UCP CLI で ucp catalog search を実行します）

認証: 変更なし
移行前に試す道具: Shopify AI Toolkit
もう1つ: UCP CLI の ucp catalog search