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ấp truy cập và vai trò của người dùng cho tài khoản Google Ads. Google Ads API 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ể lấy 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 câu lệnh Ngôn ngữ truy vấn của Google Ads để truy vấn tất cả các thực thể CustomerUserAccess đượ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 của nhiều bên, thì thay đổi đó sẽ không xuất hiện khi 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 ý: Google Ads API có thể tạo một 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.

Để cập nhật một vai trò hiện có của người dùng, bạn cần gọi CustomerUserAccessService.MutateCustomerUserAccess. 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 yêu cầu phê duyệt nhiều bên được kích hoạt:

• MutateCustomerUserAccessResponse sẽ điền vào trường multi_party_auth_review chứa tên tài nguyên của yêu cầu xem xét đang chờ phê duyệt.
• Trường resource_name sẽ không được điền sẵ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 ý: Google Ads API có thể tạo một 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.

Nếu yêu cầu phê duyệt nhiều bên được kích hoạt:

• MutateCustomerUserAccessResponse sẽ điền vào trường multi_party_auth_review chứa tên tài nguyên của yêu cầu xem xét đang chờ phê duyệt.
• Trường resource_name sẽ không được điền sẵ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.