Authentication

Запросы к ReachPlanService должны содержать учетные данные OAuth и идентификатор клиента, к которому эти учетные данные имеют доступ. Кроме того, проект Google Cloud, к которому относятся учетные данные OAuth, должен быть одобрен для использования данной службы.

В этом руководстве описаны особенности аутентификации, специфичные для ReachPlanService . Если вы еще этого не сделали, сначала выполните шаги, описанные в разделе «Начало работы» , а затем вернитесь к этому разделу.

Учетные данные OAuth

В дополнение к рекомендациям, представленным в разделе «Начало работы» , учитывайте следующие моменты:

1. Для подключения к ReachPlanService номер вашего проекта Google Cloud должен быть добавлен в соответствующий список разрешенных, даже если он уже одобрен для использования с другими сервисами Google Ads API. Для получения дополнительной информации см. требования к участию .
2. Для подключения к API Google Ads необходимо принять Условия использования API Google Ads.
3. Пользователь, которому принадлежит ваш токен обновления 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, выберите один из двух подходов в зависимости от вашей ситуации и определите несколько идентификаторов клиентов для тестирования. Если сомневаетесь, используйте первый предложенный подход для вашего типа инструмента.

Что дальше?

Узнайте, как составить медиаплан .

,

Запросы к ReachPlanService должны содержать учетные данные OAuth и идентификатор клиента, к которому эти учетные данные имеют доступ. Кроме того, проект Google Cloud, к которому относятся учетные данные OAuth, должен быть одобрен для использования данной службы.

В этом руководстве описаны особенности аутентификации, специфичные для ReachPlanService . Если вы еще этого не сделали, сначала выполните шаги, описанные в разделе «Начало работы» , а затем вернитесь к этому разделу.

Учетные данные OAuth

В дополнение к рекомендациям, представленным в разделе «Начало работы» , учитывайте следующие моменты:

1. Для подключения к ReachPlanService номер вашего проекта Google Cloud должен быть добавлен в соответствующий список разрешенных, даже если он уже одобрен для использования с другими сервисами Google Ads API. Для получения дополнительной информации см. требования к участию .
2. Для подключения к API Google Ads необходимо принять Условия использования API Google Ads.
3. Пользователь, которому принадлежит ваш токен обновления 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, выберите один из двух подходов в зависимости от вашей ситуации и определите несколько идентификаторов клиентов для тестирования. Если сомневаетесь, используйте первый предложенный подход для вашего типа инструмента.

Что дальше?

Узнайте, как составить медиаплан .