Групповое одобрение в Google Ads API

Четверг, 25 июня 2026 г.

Чтобы повысить безопасность аккаунтов Google Рекламы, для выполнения через Google Ads API действий, связанных с безопасностью, будет требоваться групповое одобрение. Это часть более масштабного изменения в Google Рекламе, которое требует группового одобрения для выполнения действий, связанных с безопасностью, в аккаунте Google Рекламы. Эти важные обновления системы безопасности будут внедрены с 27 июля 2026 года. В течение следующих нескольких недель они станут доступны всем пользователям.

Что изменилось

Когда это изменение вступит в силу, поведение следующих вызовов API изменится.

Как пригласить пользователя

Если вы используете метод CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation, чтобы пригласить нового пользователя для управления аккаунтом Google Рекламы, Google Ads API теперь оценивает, требуется ли групповое одобрение. Если наши серверы определят, что требуется проверка, система приостановит стандартный рабочий процесс и не будет сразу создавать CustomerUserAccessInvitation или отправлять электронное письмо с приглашением. Вместо этого инициируется ресурс MultiPartyAuthReview, а его название указывается в ответе. После того как второй администратор аккаунта одобрит запрос, будет создан CustomerUserAccessInvitation и приглашенный пользователь получит электронное письмо. Пока проверка не завершится, новые приглашения для пользователя создать нельзя.

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

Если вы используете метод CustomerUserAccessService.MutateCustomerUserAccess, чтобы изменить разрешения пользователя с помощью операции обновления или отменить доступ с помощью операции удаления, Google Ads API теперь оценивает, требуется ли групповое одобрение. Если наши серверы определят, что требуется проверка, API создаст ресурс MultiPartyAuthReview в состоянии ожидания и вернет его название. Изменения, сделанные вами, будут вступать в силу только после того, как второй администратор аккаунта одобрит их. Объект типа CustomerUserAccess, находящийся на рассмотрении, нельзя изменить, пока не будет завершена проверка.

Как одобрить запрос на групповое одобрение?

Вы можете получить ожидающий объект MultiPartyAuthReview с помощью методов GoogleAdsService.Search или GoogleAdsService.SearchStream, используя следующий запрос GAQL. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

Ожидающий запрос MultiPartyAuthReview можно одобрить или отклонить с помощью запроса к API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Проверку должен выполнить второй администратор, который не создавал исходный запрос. Это может быть человек или сервисный аккаунт с правами администратора. Пользователь, отправивший запрос, может его отозвать.

Что нужно сделать?

Если в вашем приложении используются эти методы, обновите его, чтобы оно могло обрабатывать рабочие процессы с групповым одобрением, до 27 июля 2026 г. Групповое одобрение теперь поддерживается во всех основных версиях API (24.2, 23.3, 22.2 и 21.2). Если вы используете официальную клиентскую библиотеку, скачайте ее последнюю версию. Чтобы узнать больше об этих изменениях, ознакомьтесь с приведенными ниже руководствами. В них описывается следующее:

Если у вас есть вопросы или вы хотите обсудить это изменение, свяжитесь с нами на сервере Discord сообщества Google по рекламе и аналитике. Если у вас возникли технические проблемы, обратитесь в службу поддержки: https://support.google.com/google-ads/contact/google_ads_api.

Портрет автора – , Google Ads API Team

Ярлыки: authorization, google-ads-api