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 の通知を投稿します。