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