Search Ads 360 Reporting API のバージョニング
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Search Ads 360 Reporting API はセマンティック バージョニングを使用します。
メジャー バージョンとマイナー バージョンがあり、vMAJOR_MINOR の形式で指定します。たとえば、v0_0 は最初のメジャー バージョンで、v0_1 は最初のマイナー バージョンです。バージョン番号の接尾辞はバージョン タイプを示します。メジャー バージョンの場合は常に 0、マイナー バージョンの場合は常に 0 より大きくなります。
メジャー バージョン
メジャー リリースでは、互換性を損なう変更が導入されます。
各メジャー バージョンには個別のエンドポイントがあります。次に例を示します。
https://searchads360.googleapis.com/v0
https://searchads360.googleapis.com/v1
メジャー バージョンから別のメジャー バージョンにアップグレードする場合は、新しいメジャー バージョンのエンドポイントに切り替える前にコードを変更する必要があります。
クライアント ライブラリを使用している場合は、最新バージョンにアップグレードする必要があります。新しいメジャー バージョンには、コードの互換性を損なう変更を修正するのに役立つ移行ガイドが用意されています。
互換性を損なう変更の例としては、次のようなものが挙げられます。
- サービス、インターフェース、フィールド、メソッド、列挙値の削除または名前変更。
- フィールドのタイプの変更。
- リソース名の形式の変更。
- HTTP 定義での URL 形式の変更。
- 出力形式の変更（デフォルト値として
0 を -- に変更するなど）。
- 返されるエラーの理由を A から B に変更。
マイナー バージョン
マイナー バージョンでは、下位互換性のある変更のみが導入されます。
マイナー バージョンがリリースされると、すでに使用されているエンドポイントは自動的に更新されます。コードが破損することはありません。既存のクライアント ライブラリは引き続き使用できます。
マイナー バージョンには、既存のコードに影響しない新機能や更新が含まれます。新機能を使用するには、クライアント ライブラリを最新バージョンにアップグレードする必要があります。
廃止
以前のバージョンの Search Ads 360 Reporting API のサポートが終了する予定の場合は、searchads-api-announcements Google グループに通知が投稿されます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[[["\u003cp\u003eThe Search Ads 360 Reporting API uses semantic versioning with major and minor versions, where major versions introduce breaking changes and minor versions are backwards-compatible.\u003c/p\u003e\n"],["\u003cp\u003eMajor version releases require code changes and utilize separate endpoints, while minor version releases automatically update the existing endpoint without breaking existing code.\u003c/p\u003e\n"],["\u003cp\u003eBreaking changes in major versions might involve removing or renaming elements, changing types or formats, or modifying outputs and error reasons.\u003c/p\u003e\n"],["\u003cp\u003eMinor versions bring new features or updates but do not affect existing code; to utilize new features, upgrade your client library.\u003c/p\u003e\n"],["\u003cp\u003eSunset notices for older API versions are posted on the searchads-api-announcements Google group.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API uses semantic versioning with major (e.g., v0) and minor (e.g., v0_1) versions. Major versions have breaking changes, require code modifications, a new endpoint, and client library upgrades. Minor versions are backward-compatible, automatically update the existing endpoint, and only require client library upgrades for new features. Breaking changes may involve removing or renaming elements, changing field types or output formats. Sunsets are posted on the Google group.\n"],null,["# Versioning in the Search Ads 360 Reporting API\n\nThe Search Ads 360 Reporting API uses [semantic versioning](https://semver.org/).\n\nThere are major and minor versions, formatted as\n`v`\u003cvar translate=\"no\"\u003eMAJOR\u003c/var\u003e`_`\u003cvar translate=\"no\"\u003eMINOR\u003c/var\u003e. For example, `v0_0` is the\nfirst major version, and `v0_1` the first minor version. The suffix of the\nversion number indicates the version type: for major versions it is always zero,\nand for minor versions it is always greater than zero.\n\nMajor versions\n--------------\n\nMajor releases introduce breaking changes, that is, changes that are not\nbackwards compatible.\n\nEach major version has a separate endpoint, for example: \n\n```text\nhttps://searchads360.googleapis.com/v0\n\nhttps://searchads360.googleapis.com/v1\n```\n\nWhen upgrading from one major version to another, you may need to change your\ncode before switching to the new major version endpoint.\n\nIf you use a [client library](/search-ads/reporting/client-libraries/client-libraries),\nyou need to upgrade to the newest version. New major versions provide a\nmigration guide to help you fix any breaking changes in your code.\n\nExamples of breaking changes include:\n\n- Removing or renaming a service, interface, field, method or enum value.\n- Changing the type of a field.\n- Changing a resource name format.\n- Changing the URL format in the HTTP definition.\n- Changing output formats, such as, changing `0` to `--` as the default value.\n- Changing the error reason returned from A to B.\n\nMinor versions\n--------------\n\nMinor versions introduce only backwards-compatible changes.\n\nWhen a minor version is released, the endpoint that is already in use is\nautomatically updated. This does not cause your code to break. You can continue\nto use your existing client library.\n\nMinor versions include new features or updates that do not affect your existing\ncode. If you want to use the new features, you need to upgrade your\n[client library](/search-ads/reporting/client-libraries/client-libraries) to the latest\nversion.\n\nSunsets\n-------\n\nWhen an older Search Ads 360 Reporting API version is scheduled to sunset, we\npost a notice on the [searchads-api-announcements](https://groups.google.com/g/searchads-api-announcements) Google group."]]
