API Display & Video 360 — это программный интерфейс платформы Display & Video 360. Вы можете использовать API Display & Video 360 для автоматизации сложных рабочих процессов Display & Video 360. Вот несколько примеров задач, которые можно выполнить с помощью API Display & Video 360:
- Загружайте и создавайте креативы.
- Управляйте позициями и их таргетингом.
- Создайте и загрузите файлы структурированных данных.
В этом руководстве описывается, как начать работу с API Display & Video 360.
Предварительные условия
Прежде чем использовать API Display & Video 360, вам необходимо сделать следующее:
У вас должна быть учетная запись Google. Вам понадобится учетная запись Google , чтобы создать проект в консоли Google API. Если у вас уже есть учетная запись, то все готово. Вам также может потребоваться отдельная учетная запись Google для целей тестирования.
У вас должен быть доступ к Display & Video 360. Для работы с API вам необходим доступ к продукту Display & Video 360. Если у вашей организации уже есть контракт с Display & Video 360, убедитесь, что для ваших аккаунтов Google создан профиль пользователя с соответствующими разрешениями. Если нет, свяжитесь с нашим отделом продаж для получения дополнительной информации.
Вам следует попробовать Display & Video 360. В этой документации API предполагается, что вы использовали Display & Video 360 и знакомы с концепциями веб-программирования и форматами веб-данных. Если вы еще не использовали Display & Video 360, опробуйте веб-интерфейс , прежде чем приступать к написанию кода.
Выберите проект
Вам необходимо создать или выбрать проект в консоли Google API и включить API .
Вы можете создать новый проект или использовать существующий.
Создать новый проект
Следуйте инструкциям в консоли Google API , чтобы создать проект и автоматически включить Display & Video 360 API.
Использовать существующий проект
Ниже описано, как вручную активировать API Display & Video 360 для существующего проекта.
Чтобы включить API для вашего проекта, сделайте следующее:
- Откройте библиотеку API в консоли Google API. При появлении запроса выберите проект или создайте новый. В библиотеке API перечислены все доступные API, сгруппированные по семействам продуктов и популярности.
- Если API, который вы хотите включить, не отображается в списке, воспользуйтесь поиском, чтобы найти его.
- Выберите API, который вы хотите включить, затем нажмите кнопку «Включить» .
- Если будет предложено, включите выставление счетов.
- Если будет предложено, примите Условия обслуживания API.
Создать учетные данные
Все запросы к API Display & Video 360 должны быть авторизованы. Краткий обзор авторизации читайте о том, как авторизовать и идентифицировать свое приложение в Google .
Следующие инструкции помогут вам создать идентификатор клиента OAuth 2.0 для использования в потоке установленного приложения . Инструкции по созданию учетных данных для использования с потоком учетных записей служб см. в руководстве по учетным записям служб .
Следуйте инструкциям по настройке проекта консоли Google API .
- Откройте страницу «Учетные данные» в консоли API.
Нажмите Создать учетные данные > Идентификатор клиента OAuth .
При появлении запроса выберите наиболее подходящий тип приложения. Фрагменты кода Java и Python, предлагаемые в этих руководствах, предполагают настольное приложение , а фрагменты кода PHP — веб-приложение .
Введите любую дополнительную необходимую информацию.
- Если вы впервые создаете идентификатор клиента, вы можете не только выбрать тип приложения, но и настроить экран согласия, нажав кнопку «Настроить экран согласия» . Вы не получите приглашение снова настроить экран согласия после того, как сделаете это в первый раз, хотя эту информацию можно обновить в любое время.
Нажмите Создать .
По завершении вам будет представлен идентификатор клиента OAuth 2.0 и секрет клиента, которые вы сможете скачать в формате JSON и сохранить для дальнейшего использования.
Настройка экрана согласия пользователя
Когда вы используете OAuth 2.0 для аутентификации, ваши пользователи аутентифицируются после того, как они соглашаются с условиями, представленными им на экране согласия пользователя.
Чтобы настроить экран согласия вашего проекта, выполните следующие действия:
- Откройте страницу «Экран согласия» в консоли Google API. При появлении запроса выберите проект или создайте новый.
- Заполните форму и нажмите Сохранить .