Phê duyệt nhiều bên trong Google Ads API

Thứ Năm, ngày 25 tháng 6 năm 2026

Nhằm tăng cường bảo mật cho các tài khoản Google Ads, Google Ads API sẽ bắt đầu yêu cầu quy trình phê duyệt nhiều bên khi thực hiện các hành động nhạy cảm qua API. Đây là một phần trong thay đổi lớn hơn của Google Ads, yêu cầu nhiều bên phê duyệt để thực hiện các hành động nhạy cảm trong tài khoản Google Ads của bạn. Những bản cập nhật bảo mật quan trọng này sẽ bắt đầu được triển khai từ ngày 27 tháng 7 năm 2026 và sẽ được bật cho tất cả người dùng trong vài tuần tới.

Điều gì sẽ thay đổi?

Khi thay đổi này có hiệu lực, các lệnh gọi API sau đây sẽ thay đổi hành vi.

Mời người dùng

Nếu bạn sử dụng phương thức CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation để mời người dùng mới quản lý một tài khoản Google Ads, thì Google Ads API hiện sẽ đánh giá xem có cần phê duyệt nhiều bên hay không. Trong trường hợp máy chủ của chúng tôi xác định rằng cần phải xem xét, hệ thống sẽ tạm dừng quy trình làm việc tiêu chuẩn và sẽ không tạo ngay CustomerUserAccessInvitation hoặc gửi email gửi lời mời. Thay vào đó, một tài nguyên MultiPartyAuthReview sẽ được khởi tạo, với tên tài nguyên được cung cấp trong phản hồi. Sau khi yêu cầu đang chờ xem xét được quản trị viên tài khoản thứ hai phê duyệt, CustomerUserAccessInvitation sẽ được tạo và người dùng được mời sẽ nhận được email. Bạn không thể tạo lời mời mới cho người dùng này cho đến khi yêu cầu xem xét đang chờ xử lý được giải quyết.

Cập nhật hoặc chấm dứt quyền truy cập của người dùng

Nếu bạn sử dụng phương thức CustomerUserAccessService.MutateCustomerUserAccess để điều chỉnh quyền của người dùng bằng thao tác cập nhật hoặc thu hồi quyền truy cập bằng thao tác xoá, thì Google Ads API hiện sẽ đánh giá xem có cần phê duyệt nhiều bên hay không. Trong trường hợp máy chủ của chúng tôi xác định rằng cần phải xem xét, API sẽ tạo tài nguyên MultiPartyAuthReview ở trạng thái đang chờ xử lý và trả về tên tài nguyên. Các nội dung sửa đổi mà bạn yêu cầu sẽ vẫn ở trạng thái chờ xử lý và chỉ có hiệu lực sau khi yêu cầu xem xét nhiều bên được một quản trị viên thứ hai của tài khoản phê duyệt thành công. Không thể thay đổi CustomerUserAccess đang được xem xét cho đến khi quá trình xem xét đang chờ xử lý được giải quyết.

Làm cách nào để phê duyệt yêu cầu phê duyệt nhiều bên?

Bạn có thể tìm nạp MultiPartyAuthReview đang chờ xử lý bằng phương thức GoogleAdsService.Search hoặc GoogleAdsService.SearchStream, sử dụng truy vấn GAQL sau. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

Bạn có thể phê duyệt hoặc từ chối yêu cầu MultiPartyAuthReview đang chờ xử lý bằng cách sử dụng yêu cầu API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Quản trị viên thứ hai (không phải người tạo yêu cầu ban đầu) cần phải xem xét yêu cầu này. Đây có thể là người dùng hoặc tài khoản dịch vụ có đặc quyền của quản trị viên. Người yêu cầu ban đầu có thể thu hồi yêu cầu xem xét đang chờ xử lý.

Tôi cần phải làm gì?

Nếu ứng dụng của bạn sử dụng các phương thức này, hãy nhớ cập nhật ứng dụng để xử lý quy trình phê duyệt nhiều bên trước ngày 27 tháng 7 năm 2026. Chúng tôi đã bổ sung quy trình phê duyệt nhiều bên vào tất cả các phiên bản lớn của API (v24.2, v23.3, v22.2 và v21.2). Nếu bạn đang sử dụng một thư viện ứng dụng chính thức, hãy nhớ tải phiên bản mới nhất của thư viện đó xuống. Bạn có thể tham khảo các hướng dẫn sau đây để tìm hiểu thêm về những thay đổi này, bao gồm thông tin chi tiết về

Nếu bạn có thắc mắc hoặc muốn thảo luận thêm về thông tin cập nhật này, vui lòng liên hệ với chúng tôi trên máy chủ Discord của "Cộng đồng quảng cáo và đo lường của Google". Đối với các vấn đề hỗ trợ kỹ thuật, hãy liên hệ theo địa chỉ https://support.google.com/google-ads/contact/google_ads_api

Chân dung tác giả – , Nhóm phụ trách Google Ads API

Nhãn: authorization, google-ads-api