Phiên bản ngữ nghĩa
API Google Ads tuân theo phiên bản ngữ nghĩa trong đó có
phiên bản lớn và phiên bản nhỏ. Định dạng của phiên bản này là MAJOR.MINOR hoặc
vMAJOR_MINOR Ví dụ: v17_0 là một phiên bản lớn, trong khi
v17_1 là một phiên bản nhỏ.
Hãy xem ghi chú phát hành để biết các phiên bản trước đây.
Phiên bản lớn
Các phiên bản phát hành lớn đưa ra một số thay đổi có thể gây lỗi, không tương thích ngược.
Phiên bản sẽ kết thúc bằng 0 với định dạng vX_0, trong đó X là mã chính
số phiên bản.
Mỗi phiên bản lớn có một điểm cuối riêng. Đây là ví dụ về URL mà trong đó
X là số phiên bản chính.
https://googleads.googleapis.com/vX
Nếu bạn đang nâng cấp từ một phiên bản lớn cũ, thì mã của bạn có thể cần thay đổi khi bạn chuyển sang điểm cuối mới của phiên bản lớn. Nếu bạn đang sử dụng thư viện ứng dụng, sau đó nâng cấp lên phiên bản mới nhất. Khi có một phiên bản lớn được phát hành, chúng tôi sẽ cung cấp hướng dẫn di chuyển bạn nên thực hiện để sửa mọi thay đổi có thể gây lỗi trong mã của mình.
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 từ
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ỉ tạo ra các thay đổi có khả năng tương thích ngược. Đối với phiên bản nhỏ,
vMAJOR_MINOR sẽ có số MINOR lớn hơn 0.
Khi một phiên bản nhỏ được phát hành, điểm cuối đã được sử dụng sẽ được cập nhật tự động. Điều này sẽ 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ó 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 mã hiện có. Nếu bạn muốn sử dụng các tính năng mới này, hãy nâng cấp thư viện ứng dụng lên phiên bản mới nhất.
Hoàng hôn
Theo định kỳ, các phiên bản API Google Ads cũ sẽ cần ngừng hoạt động. Chúng tôi sẽ đăng thông báo trên blog dành cho nhà phát triển khi một phiên bản sắp ngừng hoạt động. Chiến lược phát hành đĩa đơn lịch biểu ngừng sử dụng được cập nhật khi nội dung ngừng hoạt động trong tương lai ngày tháng.