Quản lý quyền truy cập của người dùng

Là quản trị viên, bạn có thể quản lý các vai trò và cấp truy cập của người dùng cho tài khoản Google Ads. API Google Ads có thể truy xuất và cập nhật vai trò của người dùng, cũng như chấm dứt quyền truy cập của người dùng vào một tài khoản. Tìm hiểu thêm về các cấp truy cập của tài khoản.

Truy xuất vai trò của người dùng

Bạn có thể xem danh sách người dùng có quyền truy cập vào một tài khoản bằng cách tạo một câu lệnh Ngôn ngữ truy vấn Google Ads để truy vấn tất cả các CustomerUserAccess thực thể được liên kết với một mã khách hàng. Sau đây là một truy vấn điển hình:

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

Lưu ý: Nếu một thay đổi về cấp truy cập của người dùng đang chờ phê duyệt nhiều bên, thì thay đổi đó sẽ không xuất hiện khi bạn truy xuất danh sách quyền truy cập của người dùng bằng phương thức GoogleAdsService.Search hoặc SearchStream. Tính năng phê duyệt nhiều bên đang trong giai đoạn thử nghiệm và có thể thay đổi trong các bản phát hành sau này.

Sửa đổi vai trò của người dùng

Lưu ý: API Google Ads có thể tạo yêu cầu phê duyệt nhiều bên để hoàn tất hành động này. Hãy tham khảo hướng dẫn về cơ chế phê duyệt nhiều bên để tìm hiểu thêm.

Thận trọng: Kể từ ngày 30 tháng 7 năm 2026, việc cập nhật hoặc xoá vai trò của người dùng thông qua API Google Ads có thể yêu cầu và kích hoạt cơ chế phê duyệt nhiều bên (MPA).

Để cập nhật vai trò hiện có của người dùng, bạn cần gọi CustomerUserAccessService.MutateCustomerUserAccess. Hãy sử dụng thao tác UPDATE và nhớ cung cấp tên tài nguyên của CustomerUserAccess cần sửa đổi, cũng như vai trò mới của người dùng.

Nếu Google xác định rằng bạn cần MPA:

• The MutateCustomerUserAccessResponse sẽ điền vào trường multi_party_auth_review chứa tên tài nguyên của bản xem xét đang chờ phê duyệt.
• Trường resource_name sẽ không được điền.
• Quản trị viên thứ hai có thể phê duyệt hoặc từ chối yêu cầu xem xét đang chờ xử lý bằng phương thức MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Hãy tham khảo hướng dẫn về cơ chế phê duyệt nhiều bên để tìm hiểu thêm.

Xoá người dùng

Lưu ý: API Google Ads có thể tạo yêu cầu phê duyệt nhiều bên để hoàn tất hành động này. Hãy tham khảo hướng dẫn về cơ chế phê duyệt nhiều bên để tìm hiểu thêm.

Để chấm dứt quyền truy cập của người dùng vào tài khoản, hãy gọi CustomerUserAccessService.MutateCustomerUserAccess bằng thao tác REMOVE.

Tương tự như việc cập nhật vai trò của người dùng, việc xoá người dùng là một hành động nhạy cảm có thể kích hoạt MPA kể từ ngày 30 tháng 7 năm 2026. Nếu MPA được kích hoạt:

• The MutateCustomerUserAccessResponse sẽ điền vào trường multi_party_auth_review chứa tên tài nguyên của bản xem xét đang chờ phê duyệt.
• Trường resource_name sẽ không được điền.
• Quản trị viên thứ hai có thể phê duyệt hoặc từ chối yêu cầu xem xét đang chờ xử lý bằng phương thức MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Hãy tham khảo hướng dẫn về cơ chế phê duyệt nhiều bên để tìm hiểu thêm.