Search Ads 360 Reporting API sử dụng phiên bản ngữ nghĩa.
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ụ:
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ể 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
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ỉ 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.