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