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