Часто задаваемые вопросы

Общий

Какая последняя версия API?

Последняя версия API, рассматриваемая в этом документе, — v3 .

Могу ли я получить данные о производительности с помощью этого API?

Нет. Используйте Bid Manager API для создания, получения и запуска офлайн-отчетов Display & Video 360.

Используйте API

Какой URL-адрес я использую для доступа к API?

https://displayvideo.googleapis.com

Какие методы аутентификации поддерживаются?

OAuth 2.0 — единственный поддерживаемый метод аутентификации.

Запросы API Display & Video 360 должны быть авторизованы в следующей области:

• https://www.googleapis.com/auth/display-video

Запросы к службе users также должны быть авторизованы для следующей дополнительной области:

• https://www.googleapis.com/auth/display-video-user-management

Я хочу написать код. Где я могу найти клиентские библиотеки?

Обратитесь к руководству по клиентской библиотеке .

Что делать, если я не хочу использовать клиентскую библиотеку?

Мы рекомендуем вам использовать одну из наших клиентских библиотек, но вы также можете взаимодействовать с API Display & Video 360, используя прямые HTTP-запросы.

Некоторые более сложные методы, такие как advertisers.assets.upload и media.upload , сложнее преобразовать непосредственно в HTTP-запросы. См. примеры HTTP-запросов к этим методам с использованием cURL в наших руководствах по креативам и специальным ставкам .

Какие разрешения Display & Video 360 мне нужны?

Чтобы использовать API Display & Video 360, аутентифицирующий аккаунт Google должен быть пользователем Display & Video 360 с доступом к соответствующим партнерам или рекламодателям.

Пользователь Display & Video 360 должен иметь одну из следующих ролей пользователя , чтобы соответствующие партнеры или рекламодатели могли выполнять следующие действия:

• Только для чтения : получение ресурсов с помощью вызовов get или list , за исключением user ресурсов.
• Стандартный : получение, создание и обновление ресурсов. Получайте user ресурсы с разрешениями для тех же партнеров или рекламодателей.
• Администратор : получение, создание и обновление ресурсов. Получайте, создавайте и предоставляйте доступ к user ресурсам партнерам или рекламодателям, которых вы администрируете.

Как обновить ресурсы YouTube и партнеров с помощью API?

API Display & Video 360 не поддерживает создание и обновление ресурсов YouTube и партнеров. Создавайте или обновляйте ресурсы YouTube и партнеров массово, загружая файлы структурированных данных (SDF) в интерфейс Display & Video 360 . Более подробную информацию о том, как использовать загрузку SDF, можно найти на странице руководства , посвященной ресурсам YouTube и партнеров.

Как настроить таргетинг на географические местоположения?

Географический таргетинг можно назначить позициям, используя следующие типы таргетинга:

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Получите идентификаторы параметров таргетинга для первых трех типов таргетинга, используя targetingTypes.targetingOptions.search . Получайте ресурсы списка местоположений и управляйте ими с помощью службы advertisers.locationLists .

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

Я вижу, что могу загружать файлы структурированных данных (SDF) с помощью API, но как мне их загрузить?

API Display & Video 360 не поддерживает загрузку SDF. Вместо этого мы рекомендуем управлять ресурсами с помощью методов CREATE , PATCH и DELETE , предоставляемых API. Если вы по-прежнему хотите управлять ресурсами с помощью файлов SDF, эти файлы можно обновить в интерфейсе Display & Video 360 .

Поддерживать

Есть ли у API какие-либо известные проблемы или ограничения?

Существуют ограничения на количество запросов, которые ваш проект может выполнять в секунду, которые описаны в нашем руководстве по ограничениям использования .