API Báo cáo Search Ads 360 sử dụng phiên bản ngữ nghĩa.
Có các phiên bản lớn và nhỏ, được định dạng là
vMAJOR_MINOR. Ví dụ: v0_0 là
phiên bản lớn đầu tiên và v0_1 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 các phiên bản lớn, số này luôn bằng 0,
và đối với các phiên bản nhỏ, giá trị này luôn lớn hơn 0.
Phiên bản lớn
Các bản phát hành chính giới thiệu những thay đổi có thể gây lỗi, tức là những thay đổi chưa được thực hiện 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ụ:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
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ể cần 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 bạn 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 chính mới sẽ mang đến 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à ví dụ về những 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
0thà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ỉ đưa ra những thay đổi có khả năng tương thích ngược.
Khi một phiên bản nhỏ được phát hành, điểm cuối đã được sử dụng sẽ tự động 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 tại của bạn.
Cá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 hiện có . Nếu muốn sử dụng các tính năng mới, bạn cần phải 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 cung cấp, chúng tôi đăng thông báo trên nhóm searchads-api-announcements trên Google.