Search Ads 360 Reporting API のバージョニング

Search Ads 360 Reporting API では、セマンティック バージョニングを使用します。

メジャー バージョンとマイナー バージョンには、 vMAJOR_MINOR。たとえば、v0_0 は、 最初のメジャー バージョン、v0_1 は最初のマイナー バージョンです。名前の接尾辞は、 version number はバージョン タイプを示します。メジャー バージョンの場合、常に 0 になります。 マイナー バージョンの場合は常に 0 より大きくなります。

メジャー バージョン

メジャー リリースでは、互換性を破る変更(Google 以外の 下位互換性があります。

各メジャー バージョンには個別のエンドポイントがあります。次に例を示します。

https://searchads360.googleapis.com/v0

https://searchads360.googleapis.com/v1

あるメジャー バージョンから別のメジャー バージョンにアップグレードする場合、 新しいメジャー バージョンのエンドポイントに切り替える必要があります。

クライアント ライブラリを使用する場合は、 最新バージョンにアップグレードする必要があります新しいメジャー バージョンでは、 移行ガイドをご利用いただけます。

互換性を破る変更の例:

  • サービス、インターフェース、フィールド、メソッド、列挙値の削除または名前の変更。
  • フィールドの型の変更。
  • リソース名の形式の変更。
  • HTTP 定義内の URL 形式の変更。
  • 出力形式の変更(デフォルト値として 0-- に変更するなど)。
  • 返されたエラーの理由を A から B に変更する。

マイナー バージョン

マイナー バージョンでは、下位互換性のある変更のみが導入されます。

マイナー バージョンがリリースされると、すでに使用されているエンドポイントは 自動的に更新されます。これによってコードが機能しなくなることはありません。続行できます 既存のクライアント ライブラリを使用できます。

マイナー バージョンには、既存のバージョンに影響しない新機能やアップデートが含まれます できます。新機能を使用するには、 クライアント ライブラリを最新バージョンに できます。

廃止

旧バージョンの Search Ads 360 Reporting API の廃止が予定されている場合は、 Google グループに searchads-api-announcements の通知を投稿します。