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