セマンティック バージョニング
Google Ads API は、メジャー バージョンとマイナー バージョンがあるセマンティック バージョニングに従います。バージョンの形式は MAJOR.MINOR または vMAJOR_MINOR です。たとえば、v21_0 はメジャー バージョンで、v21_1 はマイナー バージョンです。
過去のバージョンについては、リリースノートをご覧ください。
メジャー バージョン
メジャー リリース バージョンでは、下位互換性のない変更が導入されます。バージョンは 0 で終わり、vX_0 の形式になります。ここで、X はメジャー バージョン番号です。
各メジャー バージョンには個別のエンドポイントがあります。この URL の例では、X がメジャー バージョン番号です。
https://googleads.googleapis.com/vX
古いメジャー バージョンからアップグレードする場合は、新しいメジャー バージョンのエンドポイントに切り替えるときにコードの変更が必要になることがあります。Google のクライアント ライブラリを使用している場合は、最新バージョンにアップグレードしてください。メジャー バージョンがリリースされた場合は、コードの互換性を損なう変更を修正するために使用する移行ガイドが提供されます。
互換性を損なう変更の例としては、次のようなものが挙げられます。
- サービス、インターフェース、フィールド、メソッド、列挙値の削除や名前変更。
- フィールドのタイプを変更する。
- リソース名の形式の変更。
- HTTP 定義での URL 形式の変更。
- 出力形式の変更（デフォルト値を
0から--に変更するなど）。 - 返されるエラー理由を A から B に変更します。
マイナー バージョン
マイナー バージョンでは、下位互換性のある変更のみが導入されます。マイナー バージョンの場合、vMAJOR_MINOR の MINOR 番号は 0 より大きくなります。
マイナー バージョンがリリースされると、すでに使用されているエンドポイントは自動的に更新されます。これによりコードが破損することはありません。既存のクライアント ライブラリは引き続き使用できます。
マイナー バージョンには、既存のコードに影響しない新機能や更新が含まれています。これらの新機能を使用する場合は、クライアント ライブラリを最新バージョンにアップグレードしてください。
廃止
古い Google Ads API バージョンは定期的に廃止されます。バージョンのサポートが終了する際は、デベロッパー ブログでお知らせします。サポート終了スケジュールが、今後の廃止日とともに更新されます。