セマンティック バージョニング
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 は、定期的に廃止する必要があります。通知を投稿する デベロッパー ブログ 通知する場合に便利です「 サポート終了スケジュールは今後の廃止に伴って更新されます できます。