В этом руководстве для извлечения кампаний Google Реклама используется клиентская библиотека .
Чтобы включить доступ через API, сначала получите необходимые учетные данные OAuth2.
Затем добавьте данные авторизации и учетной записи в файл конфигурации. После настройки файла конфигурации вы готовы вызывать API.
Параметры конфигурации для клиентской библиотеки
Предоставьте следующую информацию в файле конфигурации вашей клиентской библиотеки.
- Токен разработчика
Ваш токен разработчика позволяет вашему приложению получить доступ к API, но этот токен не ограничивается только одним аккаунтом Google Реклама. После того как ваш токен будет одобрен, вы сможете использовать один и тот же токен для запросов ко всем своим аккаунтам Google Рекламы, даже если они не связаны с управляющим аккаунтом Google Рекламы, связанным с токеном.
Учетные записи, которыми вы управляете, авторизованы учетными данными OAuth из управляющей учетной записи. Учетной записи менеджера требуется только один набор учетных данных для управления всеми ее дочерними учетными записями.
Только одобренные токены могут подключаться к API для рабочих аккаунтов Google Рекламы; ожидающие токены могут подключаться только к тестовым учетным записям.
Чтобы получить токен разработчика, войдите в свою учетную запись менеджера и перейдите в Центр API ( ИНСТРУМЕНТЫ И НАСТРОЙКИ > НАСТРОЙКА > Центр API ).
- Идентификатор клиента клиента
Идентификатор клиента — это номер аккаунта клиента Google Реклама, которым вы хотите управлять с помощью API. Обычно он имеет форму
123-456-7890.
При желании идентификатор клиента клиента можно не указывать в файле конфигурации и установить программно. После того как ваш токен разработчика будет одобрен, вы сможете использовать идентификатор клиента из рабочей учетной записи вместо тестовой учетной записи .
- Идентификатор клиента OAuth2 и секрет клиента
Идентификатор клиента OAuth2 и секрет клиента сопоставляют ваше клиентское приложение с проектом в Google API Console и используются для аутентификации OAuth2, что позволяет вашему приложению работать от имени вашей учетной записи. Они идентифицируют ваше приложение в Google и позволяют создавать токены OAuth для управления пользователями Google Ads. Дополнительные сведения см. в разделе Создание идентификатора клиента и секрета клиента .
- Токены доступа и обновления OAuth2
Прежде чем ваше приложение сможет получить доступ к личным данным с помощью API, оно должно получить маркер доступа OAuth2 , который предоставляет доступ к API.
Если вы используете клиентские библиотеки, токен доступа OAuth2 позаботится о вас автоматически. В противном случае попробуйте получить токены через OAuth Playground .
Токены доступа OAuth2 истекают через ограниченное время. По этой причине клиентские библиотеки используют маркер обновления OAuth2 для автоматического повторного создания маркера доступа OAuth2. Токен доступа и обновления содержит инструкции по созданию токена обновления.