В запросах к ReachPlanService необходимо указывать учетные данные OAuth и идентификатор клиента, к которому у этих учетных данных есть доступ. Кроме того, проект Google Cloud, связанный с вашими учетными данными OAuth, должен быть одобрен для использования этого сервиса.
В этом руководстве рассматриваются особенности аутентификации, характерные для ReachPlanService. Если вы ещё не выполнили инструкции из раздела Начало работы, сделайте это, а затем вернитесь к этому руководству.
Учетные данные OAuth
Помимо информации, приведенной в разделе Начало работы, учитывайте следующие моменты:
- Номер вашего облачного проекта Google Cloud необходимо добавить в соответствующий белый список, чтобы подключиться к
ReachPlanService, даже если он уже одобрен для использования с другими сервисами 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, выберите один из описанных выше подходов в соответствии с системными требованиями и определите несколько тестовых идентификаторов клиентов. Если вы сомневаетесь, начните с процесса аутентификации одного пользователя со связанными аккаунтами.
Дальнейшие действия
Подробнее о том, как указать медиаплан…