管理用户访问权限

作为管理员，您可以管理 Google Ads 账号的用户访问权限级别和角色。您可以使用 Google Ads API 检索和更新用户角色、发送用户邀请以及终止用户对账号的访问权限。 详细了解账号访问权限级别。

如需管理用户访问权限，调用用户或服务账号必须对目标账号拥有 ADMIN 访问权限。

邀请用户

如需邀请新用户访问账号，请使用 CustomerUserAccessInvitationService创建并发送邀请（请参阅 管理用户访问权限邀请）。用户接受邀请后，系统会在 CustomerUserAccess 下将其显示为已确认用户。

检索用户角色

您可以构建 Google Ads 查询语言语句，查询与客户 ID 关联的所有 CustomerUserAccess实体，从而获取有权访问账号的用户列表。以下是一个典型查询：

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

修改用户角色

如需更新现有用户角色，请使用 UPDATE 操作调用 CustomerUserAccessService.MutateCustomerUserAccess。修改用户角色时，您必须提供以下信息：

• 要修改的 CustomerUserAccess 实体的资源名称，格式为 customers/{customer_id}/customerUserAccesses/{user_id}。
• access_role 中的新用户角色。
• 指定 access_role 的 update_mask (FieldMask)。

移除用户

如需终止用户对账号的访问权限，请使用 REMOVE 操作调用 CustomerUserAccessService.MutateCustomerUserAccess，并指定资源名称 (customers/{customer_id}/customerUserAccesses/{user_id})。

针对访问权限更改的多方审批

如果在调用 MutateCustomerUserAccess 时触发了多方审批请求，则：

• MutateCustomerUserAccessResult 对象 （包含在 result 字段中 MutateCustomerUserAccessResponse）会将 multi_party_auth_review 字段填充为需要审批的待审核请求的资源名称。
• MutateCustomerUserAccessResult 的 resource_name 字段将不会 填充任何内容。
• 待审核请求可由第二位 管理员使用 MultiPartyAuthReviewService.ResolveMultiPartyAuthReview 方法批准或拒绝。如需了解详情，请参阅多方审批 指南。