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