バージョニング

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

セマンティック バージョニング

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_MINORMINOR 数値は 0 より大きくなります。

マイナー バージョンがリリースされると、すでに使用されているエンドポイントが自動的に更新されます。これにより、コードが破損することはありません。既存のクライアント ライブラリは引き続き使用できます。

マイナー バージョンには、既存のコードに影響しない新機能やアップデートが含まれます。これらの新機能を使用する場合は、クライアント ライブラリを最新バージョンにアップグレードしてください。

日の入り

Google Ads API の古いバージョンは定期的に廃止する必要があります。バージョンのサポート終了が近づいたら、デベロッパー ブログでお知らせします。非推奨スケジュールは、今後の廃止日で更新されます。