Запросы к ReachPlanService должны содержать утвержденный токен разработчика, учетные данные OAuth и идентификатор клиента, к которому ваши учетные данные OAuth имеют доступ.
В этом руководстве описаны особенности аутентификации, специфичные для ReachPlanService . Если вы еще этого не сделали, сначала выполните шаги, описанные в разделе «Начало работы» , а затем вернитесь к этому разделу.
Токен разработчика и учетные данные OAuth
В дополнение к рекомендациям, представленным в разделе «Начало работы» , учитывайте следующие моменты:
- Для подключения к
ReachPlanServiceваш токен разработчика должен быть добавлен в соответствующий список разрешенных сервисов, даже если он уже одобрен для использования с другими сервисами Google Ads API. Для получения дополнительной информации см. требования к участию . - Для подключения к API Google Ads необходимо принять Условия использования API Google Ads.
- The user who owns your OAuth refresh token determines which customer IDs you can query in the
ReachPlanService. This informs your integration and is explained in more detail in the following sections.
Идентификаторы клиентов
Большинство сервисов в рамках API Google Ads работают с конкретными аккаунтами и кампаниями Google Ads. В результате большинство запросов требуют как идентификатора клиента для идентификации аккаунта, которым вы управляете или к которому обращаетесь, так и учетных данных OAuth , имеющих разрешение на доступ к этому идентификатору клиента. Однако ReachPlanService предназначен для планирования видеорекламы, которое может происходить до того, как вы узнаете конкретный идентификатор клиента, для которого будет запущена кампания.
Внутренние инструменты
Если вы разрабатываете инструменты для внутреннего использования в вашей организации, вот наши рекомендации.
Планировщики без прямого доступа к клиентским аккаунтам
Если у ваших планировщиков нет доступа к аккаунтам Google Ads ваших клиентов, сгенерируйте учетные данные OAuth, используя установленный поток приложения , для пользователя, имеющего доступ к учетной записи менеджера, содержащей ваш токен разработчика. Затем создайте или получите учетную запись Google Ads для каждой команды, использующей ваш инструмент, и свяжите их с вашей учетной записью менеджера . При отправке запросов в ReachPlanService указывайте идентификатор клиента, соответствующий команде пользователя.
Планировщики, имеющие доступ к клиентским аккаунтам.
If your planners have access to a Google Ads manager account that manages your clients' accounts, implement the web application flow to allow your app to use your planners' OAuth credentials. Then you can pass in the customer ID corresponding to the customer of your plan.
Внешние инструменты
Если вы разрабатываете инструмент для внешних пользователей, мы рекомендуем аналогичные подходы:
Учетные записи отдельных клиентов
Сгенерируйте учетные данные OAuth, используя установленный поток приложения , для пользователя, имеющего доступ к учетной записи менеджера вашего токена разработчика. Создайте учетную запись Google Ads для каждого внешнего клиента и свяжите их с вашей учетной записью менеджера . Затем настройте свой инструмент так, чтобы он предоставлял соответствующий идентификатор клиента при создании тарифных планов.
Доступ, предоставленный пользователем
Предоставьте пользователям возможность предоставлять вашему инструменту доступ к своим учетным записям, используя веб-интерфейс приложения . После того, как пользователь предоставит разрешение, используйте службу CustomerService , чтобы предоставить ему список учетных записей Google Ads, к которым он может получить доступ.
Цель состоит в том, чтобы свести к минимуму сложности для планировщиков при использовании ReachPlanService . Прежде чем интегрировать API, выберите один из двух подходов в зависимости от вашей ситуации и определите несколько идентификаторов клиентов для тестирования. Если сомневаетесь, используйте первый предложенный подход для вашего типа инструмента.
Что дальше?
Узнайте, как составить медиаплан .