バージョニング

このガイドでは、Merchant API がバージョニング、リリース、さまざまなバージョンのライフサイクルを処理する方法について説明します。

バージョニング体系

Merchant API では、サブ API レベルでバージョニング戦略を採用しています。つまり、各 Merchant API（Merchant API 内の Products など）には、独自のバージョン ライフサイクルがあります。

バージョニングの形式と表示

  • 安定版のサブ API バージョン: サブ API が安定版の場合、そのすべてのメソッドは安定版です。安定版のサブ API バージョンは vX（例: v1、v2）として表されます。これらは、プロダクション レディなメジャー バージョンです。

  • アルファ版サブ API バージョン: サブ API がアルファ版の場合、そのすべてのメソッドはアルファ版です。アルファ版のサブ API バージョンは、vXalpha（例: v1alpha、v2alpha）として表されます。これらには、テストと迅速なイテレーションを目的とした試験運用版の早期アクセス機能が含まれています。アルファ版には安定性の保証はなく、定義された有効期間もありません。30 日間の通知期間で変更または廃止される可能性があります。

バージョンの変更

  • メジャー バージョンの増分（例: v1 から v2）: 下位互換性のない変更や互換性を破る変更を示します。デベロッパーによる対応が必要です。安定版のサブ API の互換性を破る変更にのみ、新しいバージョン番号が割り当てられます。たとえば、v1 から v2。
  • マイナーな変更: 下位互換性のある追加や修正は、既存のメジャー バージョンへの変更として提示されます。このような変更については、そのメジャー バージョンのリリースノートに詳しく記載されます。サブ API への非破壊的な追加は、最新の安定版のアルファ チャンネルにリリースされるか、最新の安定版に直接リリースされます。

サポート終了ポリシー

Google は、古い Merchant サブ API バージョンを定期的に廃止しています。Google は、安定版のメジャー バージョン（vX）について、正式なサポート終了の発表から 12 か月間のサポート終了期間を設けることをお約束します。

たとえば、2026 年 1 月 15 日に Products サブ API の v1 のサポートを終了した場合、2027 年 1 月 15 日以降に廃止されます。この日を過ぎると、以前のバージョンのサブ API は使用できなくなります。

サブ API のバージョンとライフサイクル ステータス

次の表に、Merchant API の各サブ API の最新バージョンを示します。

サブ API バージョン ステータス
アカウント v1
v1alpha 		アクティブ
アクティブ
コンバージョン数 v1 アクティブ
データソース v1 アクティブ
在庫 v1 アクティブ
問題の解決 v1 アクティブ
ローカル フィード パートナー プログラム v1 アクティブ
通知 v1 アクティブ
注文の追跡 v1 アクティブ
プロダクト v1 アクティブ
Product Studio v1alpha アクティブ
プロモーション v1 アクティブ
割り当て v1 アクティブ
レポート v1 アクティブ
クチコミ v1alpha アクティブ

ベスト プラクティス

  • リリースノートと最新情報を定期的に確認して、新しいバージョン、大型アップデート、改善、サブ API のリリースとサポート終了に関するお知らせを確認してください。
  • サブ API に 2 つ以上の安定版がある場合は、常に最新バージョンを使用することをおすすめします。
  • ネットワークの問題、レート制限、新しいサブ API バージョンで導入される可能性のある新しいエラーコードやメッセージなど、さまざまなサブ API エラーを適切に処理するようにアプリケーションを設計します。
  • サブ API バージョンのサポート終了が近づくまで、アップグレードの計画を待たないでください。新しいバージョンが利用可能になったら、すぐに評価とテストを開始します。
  • サブ API のロードマップに関する機能リクエストや懸念事項については、質問やフィードバックをお寄せください。Merchant API チームにテクニカル サポートを依頼する方法については、Merchant API に関するサポートを受けるをご覧ください。
前へ
Design
次へ
Known issues