Thứ Tư, ngày 4 tháng 11 năm 2026
Đầu năm nay, Google Ads API đã bắt đầu yêu cầu quy trình phê duyệt nhiều bên (MPA) khi thực hiện các hành động nhạy cảm qua API. Kể từ tuần bắt đầu từ ngày 7 tháng 12 năm 2026, chúng tôi sẽ triển khai thêm một số thay đổi để cải thiện trải nghiệm của nhà phát triển đối với quy trình phê duyệt nhiều bên.
Điều gì sẽ thay đổi?
Tạo lời mời cấp quyền truy cập bị trì hoãn: Nếu cần có sự phê duyệt của nhiều bên, thì phương thức CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation sẽ trì hoãn việc tạo tài nguyên lời mời cấp quyền truy cập cho đến khi yêu cầu phê duyệt nhiều bên được phê duyệt. Trường resource_name không được điền sẵn trong những trường hợp như vậy. Sau khi yêu cầu MPA đang chờ xử lý được phê duyệt, tài nguyên lời mời truy cập sẽ có trong kết quả xem xét. Hiện tại, phương thức này tạo lời mời và trả về resource_name của lời mời, nhưng không thực hiện các hành động bổ sung như gửi email gửi lời mời cho đến khi yêu cầu MPA liên quan được phê duyệt.
Mã lỗi mới cho các yêu cầu đã cũ: Chúng tôi sẽ bắt đầu trả về mã lỗi MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST mới trong trường lỗi một phần khi một yêu cầu MPA đang chờ xử lý không còn hợp lệ vì tài nguyên mục tiêu đã được sửa đổi hoặc xoá sau khi yêu cầu xem xét được tạo. Mã lỗi này sẽ được ra mắt trong bản phát hành v26.2 sắp tới. Các phiên bản API cũ (từ phiên bản 23 đến phiên bản 25) sẽ trả về lỗi MultiPartyAuthReviewError.UNKNOWN và trường unpublished_error_code trong GoogleAdsError.details sẽ được đặt thành MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST.
Tăng giới hạn cho các bài đánh giá MPA: Bạn có thể giải quyết tối đa 100 bài đánh giá MPA đang chờ xử lý trong một lệnh gọi đến phương thức MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Hiện tại, phương thức này chỉ cho phép một bài đánh giá cho mỗi lệnh gọi API.
Việc cần làm
Nếu bạn sử dụng quy trình phê duyệt nhiều bên, hãy xem xét và cập nhật mã để phản ánh hành vi mới của API trước ngày 7 tháng 12 năm 2026. Nếu bạn đang sử dụng phiên bản 26 của API Google Ads, hãy tải thư viện ứng dụng mới nhất xuống sau khi phiên bản 26.2 được phát hành để được hỗ trợ về mã lỗi STALE_MULTI_PARTY_AUTH_REQUEST mới. Tham khảo hướng dẫn kỹ thuật của chúng tôi để tìm hiểu thêm về quy trình phê duyệt nhiều bên. Đối với các vấn đề hỗ trợ kỹ thuật, hãy liên hệ với Nhóm hỗ trợ Google Ads API. Nếu bạn có thắc mắc hoặc muốn thảo luận về bài đăng này, hãy liên hệ với chúng tôi qua máy chủ Discord của Cộng đồng quảng cáo và đo lường của Google.
– Anash P. Oommen, Nhóm phụ trách Google Ads API
Nhãn: authorization, google-ads-api, release