Thay đổi sắp tới về việc ngừng sử dụng phiên bản API Marketing để bật tính năng tự động nâng cấp phiên bản
Để nâng cao trải nghiệm chung khi sử dụng API bằng cách tăng tính liền mạch và hiệu quả, chúng tôi rất vui được thông báo về việc sắp ra mắt tính năng tự động nâng cấp phiên bản API Marketing (MAPI). Kể từ tháng 05/2024, chúng tôi sẽ bật tính năng tự động nâng cấp phiên bản cho những điểm cuối API Marketing không bị ảnh hưởng giữa các phiên bản. Tức là nếu một điểm cuối không bị ảnh hưởng giữa phiên bản không dùng nữa và phiên bản có sẵn tiếp theo, nền tảng sẽ tự động nâng cấp lệnh gọi lên phiên bản có sẵn tiếp theo thay vì trực tiếp từ chối yêu cầu.
Lập phiên bản API là cách phổ biến để xử lý các thay đổi đối với API, thường được dùng nhiều nhất để triển khai những thay đổi quan trọng. Khi phiên bản mới được phát hành, các phiên bản cũ hơn sẽ không được dùng nữa. Trong quá trình ngừng sử dụng API, nếu một ứng dụng gọi phiên bản API không dùng nữa, ứng dụng đó sẽ nhận được lỗi "(#2635) Bạn đang gọi một phiên bản API Quảng cáo không dùng nữa. Vui lòng cập nhật lên phiên bản mới nhất: vXXX".
Chúng tôi sẽ ngừng sử dụng v17.0 từ ngày 14/05/2024. Theo nhật ký thay đổi của v18.0, các điểm cuối sau đây sẽ bị ảnh hưởng:
- POST /act_{ad-account-id}/reachfrequencypredictions
- GET /act_{ad-account-id}/reachestimate
- GET /act_{ad-account-id}/delivery_estimate
- POST /act_{ad-account-id}/adsets
- POST /{adset-id}
- POST /act_{ad-account-id}/saved_audiences
- POST /{saved-audience-id}
- POST /act_{ad-account-id}/credit_cards
Nếu ứng dụng của bạn thực hiện lệnh gọi POST /{adset-id} bằng v17.0 sau khi phiên bản này không được dùng nữa vào ngày 14/05/2024, yêu cầu API nêu trên sẽ không thành công vì tính năng tự động nâng cấp không được áp dụng cho những điểm cuối bị ảnh hưởng bởi phiên bản có sẵn tiếp theo là v18.0.
Nếu ứng dụng của bạn thực hiện lệnh gọi GET /{ad-account-id}/insights bằng v17.0 sau khi phiên bản này không được dùng nữa, nền tảng sẽ nâng cấp lệnh gọi đó lên phiên bản có sẵn tiếp theo là v18.0.
Nếu ứng dụng của bạn đã thực hiện lệnh gọi bằng các phiên bản cao hơn v17.0 thì sẽ không có gì thay đổi vào ngày ngừng sử dụng phiên bản đó.
Nếu bạn muốn chọn không tự động nâng cấp phiên bản, vui lòng mở phần Cài đặt > Cài đặt phiên bản API Quảng cáo trong thẻ Sản phẩm ứng dụng API Marketing để vô hiệu hóa tính năng này.
Để xác nhận xem một lệnh gọi đã tự động được nâng cấp hay chưa, vui lòng xem tiêu đề phản hồi API để biết thêm chi tiết.
- Tiêu đề thông báo mẫu: "Cảnh báo về phiên bản API Quảng cáo X: "Lệnh gọi đã tự động được nâng cấp lên v17.0 vì v16.0 không được dùng nữa""
Để tìm hiểu thêm về hành vi này, hãy tham khảo bài viết Lập phiên bản API Marketing.
Để xem các điểm cuối bị ảnh hưởng ở mỗi phiên bản, vui lòng tham khảo Nhật ký thay đổi.
Điểm cuối bị ảnh hưởng
- Tất cả điểm cuối MAPI
Liên kết đến tài liệu dành cho nhà phát triển
Liên kết đến bài viết trợ giúp về tính năng
