В запросах к ReachPlanService необходимо указывать учетные данные OAuth и идентификатор клиента, к которому у этих учетных данных есть доступ. Кроме того, проект Google Cloud, связанный с вашими учетными данными OAuth, должен быть одобрен для использования этого сервиса.
В этом руководстве рассматриваются особенности аутентификации, характерные для ReachPlanService. Если вы ещё не выполнили инструкции из статьи Начало работы, сделайте это, а затем вернитесь к этому руководству.
Учетные данные OAuth
В дополнение к рекомендациям из раздела Начало работы учитывайте следующее:
- Чтобы подключиться к
ReachPlanService, номер вашего облачного проекта Google Cloud должен быть добавлен в соответствующий белый список, даже если он уже одобрен для использования с другими сервисами Google Ads API. Подробнее о требованиях к участникам… - Чтобы подключиться к Google Ads API, необходимо принять Условия использования Google Ads API.
- Пользователь, которому принадлежит токен обновления OAuth, определяет, какие идентификаторы клиентов вы можете запрашивать в
ReachPlanService. Это влияет на интеграцию и более подробно описано в следующих разделах.
Идентификаторы клиентов
Большинство сервисов в Google Ads API работают с определенными аккаунтами и кампаниями Google Рекламы. Поэтому в большинстве запросов требуется указать идентификатор клиента, чтобы определить целевой аккаунт, и учетные данные OAuth, авторизованные для доступа к этому идентификатору клиента.
Однако ReachPlanService предназначен для планирования видеокампаний, которое может происходить до того, как вы создадите аккаунт клиента для проведения кампании.
Собственные инструменты
Если вы разрабатываете инструменты для внутреннего использования в организации, рассмотрите следующие варианты:
- У планировщиков нет прямого доступа к клиентским аккаунтам. Если у ваших планировщиков нет доступа к аккаунтам Google Рекламы ваших клиентов, создайте учетные данные OAuth, используя процесс аутентификации одного пользователя для пользователя с доступом к вашему управляющему аккаунту. Затем создайте или получите аккаунт Google Рекламы для каждой команды, использующей ваш инструмент, и свяжите их с управляющим аккаунтом. При отправке запросов в
ReachPlanServiceуказывайте идентификатор клиента, соответствующий команде пользователя. - Планировщики с доступом к клиентскому аккаунту. Если у ваших планировщиков есть доступ к управляющему аккаунту Google Рекламы, который управляет аккаунтами ваших клиентов, реализуйте процесс многопользовательской аутентификации, чтобы ваше приложение могло использовать учетные данные OAuth ваших планировщиков. Затем вы можете передать идентификатор клиента, соответствующий тарифному плану клиента.
Внешние инструменты
Если вы создаете инструменты для сторонних или внешних пользователей, рекомендуем следующие варианты:
- Аккаунты клиентов. Создайте учетные данные OAuth, используя процесс аутентификации одного пользователя, у которого есть доступ к вашему управляющему аккаунту. Создайте аккаунт Google Рекламы для каждого внешнего клиента и свяжите их со своим управляющим аккаунтом. Настройте инструмент так, чтобы при создании планов он предоставлял идентификатор клиента.
- Доступ, предоставленный пользователем. Разрешите пользователям предоставлять вашему инструменту доступ к их аккаунтам с помощью процесса многопользовательской аутентификации. После того как пользователь предоставит разрешение, используйте
CustomerService, чтобы получить список аккаунтов Google Рекламы, к которым у него есть доступ.
Прежде чем интегрировать API, выберите один из описанных выше подходов в соответствии с системными требованиями и определите несколько идентификаторов клиентов для тестирования. Если вы сомневаетесь, начните с процесса аутентификации одного пользователя со связанными аккаунтами.
Дальнейшие действия
Подробнее о том, как указать медиаплан…