Подготовьте учетную запись клиента

На этом этапе вы определяете аккаунт Google Рекламы, к которому будут выполняться вызовы API. Вам понадобится его адрес электронной почты для создания токенов обновления OAuth 2.0 . Учетная запись может быть рабочей (действующей) или тестовой учетной записью. Каждый подход имеет свои преимущества и недостатки.

Производственные счета
Тестовые аккаунты
Преимущества
  • Легче писать и тестировать код, который работает с содержимым определенного аккаунта.
  • Легче писать и тестировать код, обрабатывающий данные отчетов в реальном времени.
  • Тестовые аккаунты не показывают рекламу, поэтому программные ошибки не повлияют на ваши активные кампании.
  • Работает с токенами разработчика, имеющими уровень тестового доступа.
Недостатки
  • Программная ошибка на этапе разработки может повлиять на показ кампании в реальном времени, что приведет к таким проблемам, как низкая эффективность кампании, неправильное обслуживание или финансовые потери.
  • Токен разработчика должен иметь как минимум базовый уровень доступа для выполнения вызовов API.
  • Вам необходимо реконструировать кампании в тестовых учетных записях, чтобы протестировать код, который работает с содержимым конкретной учетной записи.
  • Поскольку тестовые аккаунты не показывают рекламу, функции, связанные с показом в реальном времени, такие как отчеты о статистике, ошибки нарушения правил или обработка импорта офлайн-конверсий, не поддерживаются, что затрудняет тестирование этих функций.

Мы рекомендуем по возможности использовать тестовую учетную запись при разработке приложения. Инструкции см. в разделе Создание тестовых учетных записей и кампаний .

Альтернативой является настройка рабочей учетной записи с небольшим бюджетом, например 1 доллар США в день, специально для тестирования функций, которые не поддерживаются тестовой учетной записью.

Выбор набора функций

При выборе учетной записи для вызова API дополнительным фактором является список функций, которые вы хотели бы использовать с API. Даже если вы решите использовать производственную учетную запись, существуют некоторые функции, специфичные для учетной записи, например:

  • Для использования функций выставления счетов вам понадобится учетная запись, в которой выставлены ежемесячные счета.
  • Некоторые новые функции могут быть ограничены списком учетных записей, включенных в белый список.

Прежде чем завершить создание учетной записи для выполнения вызовов API, проверьте документацию конкретной функции, чтобы убедиться, что эта функция не имеет дополнительных ограничений.

Доступ пользователя, идентификатор клиента для входа и идентификатор клиента

Чтобы выполнить вызов API к клиенту Google Рекламы, вам необходим доступ к этому клиенту напрямую или через связанный управляющий аккаунт. Вам также потребуются соответствующие разрешения в зависимости от конкретного вызова API.

При входе в Google Рекламу у вас может быть несколько учетных записей клиентов на выбор. Выбранная вами учетная запись устанавливает идентификатор клиента для входа, который является обязательным заголовком для некоторых вызовов API, и ваш уровень доступа.

После того, как вы определили клиента Google Рекламы, к которому нужно совершать вызовы API, обратите внимание на следующие детали:

  • 10-значный идентификатор учетной записи клиента, к которой вы планируете выполнять вызовы API. Иногда его называют действующим клиентом.

  • Адрес электронной почты учетной записи клиента, в которую вы вошли. Это необходимо для создания токена обновления OAuth 2.0.

  • 10-значный идентификатор клиента для входа в учетную запись клиента, в которую вы вошли. Если вы вошли в систему действующего клиента, идентификатор клиента для входа совпадает с идентификатором клиента.