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