バージョニング

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

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 Chat では 既存のクライアント ライブラリを引き続き使用してください。

マイナー バージョンには、 できます。ご利用になりたい場合は、 クライアント ライブラリを最新バージョンに更新します。

廃止

古いバージョンの Google Ads API は、定期的に廃止する必要があります。通知を投稿する デベロッパー ブログ 通知する場合に便利です「 サポート終了スケジュールは今後の廃止に伴って更新されます できます。