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