API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
Có các phiên bản chính và phiên bản phụ, được định dạng là vMAJOR_MINOR. Ví dụ: v0_0 là phiên bản chính đầu tiên và v0_1 là phiên bản phụ đầu tiên. Hậu tố của số phiên bản cho biết loại phiên bản: đối với phiên bản chính, hậu tố luôn bằng 0 và đối với phiên bản phụ, hậu tố luôn lớn hơn 0.
Phiên bản lớn
Các bản phát hành chính sẽ có các thay đổi có thể gây lỗi, tức là các thay đổi không tương thích ngược.
Mỗi phiên bản lớn đều có một điểm cuối riêng, ví dụ:
Khi nâng cấp từ một phiên bản lớn lên một phiên bản lớn khác, bạn có thể phải thay đổi mã trước khi chuyển sang điểm cuối của phiên bản chính mới.
Nếu sử dụng thư viện ứng dụng, bạn cần nâng cấp lên phiên bản mới nhất. Các phiên bản lớn mới cung cấp hướng dẫn di chuyển để giúp bạn khắc phục mọi thay đổi có thể gây lỗi trong mã.
Sau đây là một số ví dụ về thay đổi có thể gây lỗi:
Xoá hoặc đổi tên một dịch vụ, giao diện, trường, phương thức hoặc giá trị enum.
Thay đổi loại trường.
Thay đổi định dạng tên tài nguyên.
Thay đổi định dạng URL trong định nghĩa HTTP.
Thay đổi định dạng đầu ra, chẳng hạn như thay đổi 0 thành -- làm giá trị mặc định.
Thay đổi lý do lỗi được trả về từ A thành B.
Phiên bản nhỏ
Các phiên bản nhỏ chỉ giới thiệu các thay đổi tương thích ngược.
Khi một phiên bản nhỏ được phát hành, điểm cuối đang được sử dụng sẽ tự động được cập nhật. Điều này không làm hỏng mã của bạn. Bạn có thể tiếp tục sử dụng thư viện ứng dụng hiện có.
Phiên bản nhỏ bao gồm các tính năng hoặc bản cập nhật mới không ảnh hưởng đến mã hiện có của bạn. Nếu muốn sử dụng các tính năng mới, bạn cần nâng cấp thư viện ứng dụng lên phiên bản mới nhất.
Hoàng hôn
Khi một phiên bản API Báo cáo Search Ads 360 cũ được lên lịch ngừng hoạt động, chúng tôi sẽ đăng thông báo trên nhóm Google searchads-api-announcements.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]
