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