管理用户访问权限

作为管理员，您可以管理 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

注意： 查询 customer_user_access 只会返回已确认的用户。可以使用 customer_user_access_invitation 查询待处理的邀请。

如果用户访问权限级别更改正在等待多方审批，则在使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法检索用户访问权限列表时，该更改不会显示。

修改用户角色

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

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

注意： 如果经理账号 (CustomerUserAccessError.LAST_ADMIN_USER_OF_MANAGER) 或没有所有者经理的有效广告投放账号 (CustomerUserAccessError.LAST_ADMIN_USER_OF_SERVING_CUSTOMER) 中仅剩一个 ADMIN 用户，则 API 会拒绝降级该用户的请求。

移除用户

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

注意： 与角色降级一样，如果请求移除经理账号 (LAST_ADMIN_USER_OF_MANAGER) 或没有所有者经理的有效广告投放账号 (LAST_ADMIN_USER_OF_SERVING_CUSTOMER) 的最后一个 ADMIN 用户，API 会拒绝该请求。

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

注意： 在修改或移除用户角色时，Google Ads API 可能会生成多方审批请求。如需了解详情，请参阅多方审批指南。

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

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