Управление доступом пользователей

Как администратор, вы можете управлять уровнями доступа и ролями пользователей для ваших аккаунтов Google Ads. API Google Ads позволяет получать и обновлять роли пользователей, а также прекращать доступ пользователей к аккаунту. Узнайте больше об уровнях доступа к аккаунтам .

Получение ролей пользователей

Вы можете получить список пользователей, имеющих доступ к учетной записи, создав запрос на языке запросов Google Ads (Google Ads Query Language) для всех сущностей 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

Примечание: Если изменение уровня доступа пользователя ожидает подтверждения от нескольких сторон, оно не будет отображаться при получении списков доступа пользователей с помощью методов GoogleAdsService.Search или SearchStream . Функция подтверждения от нескольких сторон находится в стадии бета-тестирования и может быть изменена в будущих версиях.

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

Примечание: API Google Ads может сгенерировать запрос на подтверждение от нескольких сторон для выполнения этого действия. Для получения дополнительной информации обратитесь к руководству по подтверждению от нескольких сторон .

Для обновления существующей роли пользователя необходимо вызвать метод CustomerUserAccessService.MutateCustomerUserAccess . Используйте операцию UPDATE и обязательно укажите имя ресурса CustomerUserAccess , который необходимо изменить, а также новую роль пользователя.

Если инициируется запрос на утверждение от нескольких сторон:

• Функция MutateCustomerUserAccessResponse заполнит поле multi_party_auth_review именем ресурса, ожидающего проверки и требующего утверждения.
• Поле resource_name заполняться не будет.
• Запрос на проверку может быть одобрен или отклонен вторым администратором с помощью метода MultiPartyAuthReviewService.ResolveMultiPartyAuthReview . Для получения дополнительной информации обратитесь к руководству по многостороннему утверждению .

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

Примечание: API Google Ads может сгенерировать запрос на подтверждение от нескольких сторон для выполнения этого действия. Для получения дополнительной информации обратитесь к руководству по подтверждению от нескольких сторон .

Чтобы прекратить доступ пользователя к учетной записи, вызовите метод CustomerUserAccessService.MutateCustomerUserAccess с операцией REMOVE .

Если инициируется запрос на утверждение от нескольких сторон:

• Функция MutateCustomerUserAccessResponse заполнит поле multi_party_auth_review именем ресурса, ожидающего проверки и требующего утверждения.
• Поле resource_name заполняться не будет.
• Запрос на проверку может быть одобрен или отклонен вторым администратором с помощью метода MultiPartyAuthReviewService.ResolveMultiPartyAuthReview . Для получения дополнительной информации обратитесь к руководству по многостороннему утверждению .