API Google Ads là công cụ mạnh mẽ giúp các nhà quảng cáo tự động hóa và tối ưu hóa các chiến dịch quảng cáo. Tuy nhiên, để đảm bảo tính tương thích và hiệu suất, việc hiểu rõ quy trình lập phiên bản trong API là rất quan trọng. Mỗi phiên bản mới của API Google Ads mang đến những tính năng cập nhật, đồng thời loại bỏ các tính năng đã lỗi thời. Bài viết này sẽ giúp bạn hiểu rõ cách Google lập phiên bản API, tầm quan trọng của việc sử dụng phiên bản mới nhất và cách quản lý khi phiên bản cũ ngừng hoạt động.
Mục tiêu: Hiểu rõ cách quản lý phiên bản trong API Google Ads.
Phiên bản ngữ nghĩa
API Google Ads tuân theo cấu trúc phiên bản ngữ nghĩa, bao gồm các phiên bản lớn (major) và phiên bản nhỏ (minor). Cách định dạng của phiên bản sẽ 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à phiên bản nhỏ.
Để biết chi tiết về các thay đổi ở từng phiên bản, hãy tham khảo ghi chú phát hành của Google Ads API.
Phiên bản lớn
Các phiên bản lớn bao gồm những thay đổi không tương thích ngược, có thể gây ra lỗi nếu không được cập nhật mã. Phiên bản lớn kết thúc bằng số 0, ví dụ vX_0, trong đó X là số đại diện cho phiên bản chính.
Mỗi phiên bản lớn sẽ có một điểm cuối API riêng, ví dụ:
https://googleads.googleapis.com/vX
Nếu bạn nâng cấp từ phiên bản lớn cũ, mã của bạn có thể cần phải điều chỉnh để tương thích với điểm cuối mới. Khi phát hành phiên bản lớn, Google sẽ cung cấp hướng dẫn di chuyển để giúp bạn thực hiện những thay đổi cần thiết nhằm tránh lỗi phát sinh.
Ví dụ về những thay đổi có thể gây lỗi trong phiên bản lớn:
- Xóa hoặc đổi tên 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 yêu cầu HTTP.
- Thay đổi giá trị mặc định từ 0 sang –.
- Thay đổi lý do lỗi trả về từ A sang B.
Phiên bản nhỏ
Phiên bản nhỏ chỉ bao gồm các thay đổi tương thích ngược, đảm bảo rằng mã hiện tại của bạn không bị ảnh hưởng. Định dạng của phiên bản nhỏ là vMAJOR_MINOR với MINOR lớn hơn 0.
Khi một phiên bản nhỏ được phát hành, điểm cuối sẽ tự động được cập nhật mà không làm ảnh hưởng đến mã của bạn. Những phiên bản này có thể bao gồm các tính năng hoặc cải tiến mới. Nếu muốn tận dụng các tính năng này, bạn cần cập nhật thư viện ứng dụng lên phiên bản mới nhất.
Hoàng hôn
Các phiên bản API cũ của Google Ads sẽ bị ngừng hoạt động theo lịch trình. Google sẽ đăng thông báo trước về việc ngừng hoạt động của phiên bản trên blog dành cho nhà phát triển, giúp bạn có thời gian chuyển đổi sang phiên bản mới hơn. Lịch trình ngừng hoạt động sẽ được cập nhật để thông báo trước về những thay đổi sắp tới.
Việc cập nhật và quản lý các phiên bản API Google Ads là yếu tố then chốt giúp bạn duy trì hiệu suất chiến dịch và tránh những gián đoạn không mong muốn. Bằng cách theo dõi và chuyển đổi kịp thời sang các phiên bản mới, bạn không chỉ tận dụng được những cải tiến mới mà còn đảm bảo rằng chiến dịch quảng cáo của mình luôn hoạt động ổn định. Hãy đảm bảo rằng bạn luôn theo dõi các thông báo về phiên bản để không bỏ lỡ bất kỳ thay đổi quan trọng nào.
