Как управлять доступом пользователей

Администратор может управлять уровнями доступа и ролями пользователей в аккаунтах Google Рекламы. С помощью Google Ads API можно получать и обновлять роли пользователей, отправлять приглашения и закрывать доступ к аккаунту. Подробнее об уровнях доступа к аккаунтам…

Чтобы управлять доступом пользователей, у вызывающего пользователя или сервисного аккаунта должен быть доступ ADMIN к целевому аккаунту.

Приглашать пользователей.

Чтобы пригласить нового пользователя в аккаунт, создайте и отправьте приглашение с помощью CustomerUserAccessInvitationService (см. раздел Управление приглашениями пользователей). Когда пользователь примет приглашение, он появится в разделе CustomerUserAccess.

Как получить роли пользователей

Чтобы получить список пользователей, у которых есть доступ к аккаунту, создайте запрос на языке запросов Google Рекламы, который будет возвращать все объекты 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

Изменение ролей пользователей

Чтобы изменить существующую роль пользователя, вызовите CustomerUserAccessService.MutateCustomerUserAccess с помощью операции UPDATE. При изменении роли пользователя необходимо указать:

• Название ресурса объекта CustomerUserAccess, который нужно изменить, в формате customers/{customer_id}/customerUserAccesses/{user_id}.
• Новая роль пользователя в access_role.
• update_mask (FieldMask), указывающий на access_role.

Удалить пользователей

Чтобы закрыть пользователю доступ к аккаунту, вызовите метод CustomerUserAccessService.MutateCustomerUserAccess с операцией REMOVE, указав название ресурса (customers/{customer_id}/customerUserAccesses/{user_id}).

Групповое одобрение для изменений доступа

Если при вызове MutateCustomerUserAccess активируется запрос на групповое одобрение:

• Объект MutateCustomerUserAccessResult (содержится в поле result объекта MutateCustomerUserAccessResponse) заполнит поле multi_party_auth_review названием ресурса, ожидающего проверки.
• Поле resource_name в таблице MutateCustomerUserAccessResult не будет заполнено.
• Второй администратор может одобрить или отклонить запрос на проверку, используя метод MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Подробнее о групповом одобрении…