Display & Video 360 API

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

Сервис: displayvideo.googleapis.com.

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

Документ открытия

Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:

  • https://displayvideo.googleapis.com

Ресурс REST: v1.advertisers

Методы
audit GET /v1/advertisers/{advertiserId}:audit
Проверяет рекламодателя.
bulkEditAdvertiserAssignedTargetingOptions POST /v1/advertisers/{advertiserId}:bulkEditAdvertiserAssignedTargetingOptions
Массовое изменение параметров таргетинга для одного рекламодателя.
bulkListAdvertiserAssignedTargetingOptions GET /v1/advertisers/{advertiserId}:bulkListAdvertiserAssignedTargetingOptions
Перечисляет назначенные рекламодателю параметры таргетинга по типам таргетинга.
create POST /v1/advertisers
Создает нового рекламодателя.
delete DELETE /v1/advertisers/{advertiserId}
Удаляет рекламодателя.
get GET /v1/advertisers/{advertiserId}
Получает рекламодателя.
list GET /v1/advertisers
Перечисляет рекламодателей, доступных текущему пользователю.
patch PATCH /v1/advertisers/{advertiser.advertiserId}
Обновляет существующего рекламодателя.

Ресурс REST: v1.advertisers.assets .

Методы
upload POST /v1/advertisers/{advertiserId}/assets
POST /upload/v1/advertisers/{advertiserId}/assets
Загружает актив.

Ресурс REST: v1.advertisers.campaigns .

Методы
bulkListCampaignAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}:bulkListCampaignAssignedTargetingOptions
Перечисляет назначенные параметры таргетинга кампании по типам таргетинга.
create POST /v1/advertisers/{campaign.advertiserId}/campaigns
Создает новую кампанию.
delete DELETE /v1/advertisers/{advertiserId}/campaigns/{campaignId}
Безвозвратно удаляет кампанию.
get GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}
Получает кампанию.
list GET /v1/advertisers/{advertiserId}/campaigns
Перечисляет кампании рекламодателя.
patch PATCH /v1/advertisers/{campaign.advertiserId}/campaigns/{campaign.campaignId}
Обновляет существующую кампанию.

Ресурс REST: v1.advertisers.campaigns.targetingTypes.assignedTargetingOptions .

Методы
get GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Получает один вариант таргетинга, назначенный кампании.
list GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions
Перечисляет параметры таргетинга, назначенные кампании для указанного типа таргетинга.

Ресурс REST: v1.advertisers.channels

Методы
create POST /v1/advertisers/{advertiserId}/channels
Создает новый канал.
get GET /v1/advertisers/{advertiserId}/channels/{channelId}
Получает канал для партнера или рекламодателя.
list GET /v1/advertisers/{advertiserId}/channels
Перечисляет каналы партнера или рекламодателя.
patch PATCH /v1/advertisers/{advertiserId}/channels/{channel.channelId}
Обновляет канал.

Ресурс REST: v1.advertisers.channels.sites .

Методы
bulkEdit POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
Массовое редактирование сайтов в рамках одного канала.
create POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites
Создает сайт в канале.
delete DELETE /v1/advertisers/{advertiserId}/channels/{channelId}/sites/{urlOrAppId}
Удаляет сайт из канала.
list GET /v1/advertisers/{advertiserId}/channels/{channelId}/sites
Перечисляет сайты в канале.
replace POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:replace
Заменяет все сайты под одним каналом.

Ресурс REST: v1.advertisers.creatives

Методы
create POST /v1/advertisers/{creative.advertiserId}/creatives
Создает новое объявление.
delete DELETE /v1/advertisers/{advertiserId}/creatives/{creativeId}
Удаляет объявление.
get GET /v1/advertisers/{advertiserId}/creatives/{creativeId}
Получает креатив.
list GET /v1/advertisers/{advertiserId}/creatives
Перечисляет креативы рекламодателя.
patch PATCH /v1/advertisers/{creative.advertiserId}/creatives/{creative.creativeId}
Обновляет существующий креатив.

Ресурс REST: v1.advertisers.insertionOrders

Методы
bulkListInsertionOrderAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:bulkListInsertionOrderAssignedTargetingOptions
Перечисляет назначенные параметры таргетинга заказа на размещение для всех типов таргетинга.
create POST /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders
Создает новый заказ на размещение.
delete DELETE /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Удаляет заказ на размещение.
get GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Получает заказ на размещение.
list GET /v1/advertisers/{advertiserId}/insertionOrders
Перечисляет заказы на размещение у рекламодателя.
patch PATCH /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}
Обновляет существующий заказ на размещение.

Ресурс REST: v1.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Методы
get GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Получает один вариант таргетинга, назначенный правилу на размещение.
list GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
Перечисляет параметры таргетинга, назначенные заказу на размещение.

Ресурс REST: v1.advertisers.invoices

Методы
list GET /v1/advertisers/{advertiserId}/invoices
Перечисляет счета-фактуры, выставленные рекламодателю за определенный месяц.
lookupInvoiceCurrency GET /v1/advertisers/{advertiserId}/invoices:lookupInvoiceCurrency
Получает валюту счета, использованную рекламодателем в данном месяце.

Ресурс REST: v1.advertisers.lineItems

Методы
bulkEditLineItemAssignedTargetingOptions POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkEditLineItemAssignedTargetingOptions
Массовое изменение параметров таргетинга в рамках одной позиции.
bulkListLineItemAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkListLineItemAssignedTargetingOptions
Перечисляет назначенные параметры таргетинга позиции по типам таргетинга.
create POST /v1/advertisers/{lineItem.advertiserId}/lineItems
Создает новую позицию.
delete DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}
Удаляет позицию.
generateDefault POST /v1/advertisers/{advertiserId}/lineItems:generateDefault
Создает новую позицию с настройками (включая таргетинг), унаследованными от заказа на размещение entity_status и ENTITY_STATUS_DRAFT .
get GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}
Получает позицию.
list GET /v1/advertisers/{advertiserId}/lineItems
Перечисляет позиции рекламодателя.
patch PATCH /v1/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}
Обновляет существующую позицию.

Ресурс REST: v1.advertisers.lineItems.targetingTypes.assignedTargetingOptions .

Методы
create POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
Назначает параметр таргетинга позиции.
delete DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Удаляет назначенный параметр таргетинга из позиции.
get GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Получает один вариант таргетинга, назначенный позиции.
list GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
Перечисляет параметры таргетинга, назначенные позиции.

Ресурс REST: v1.advertisers.locationLists

Методы
create POST /v1/advertisers/{advertiserId}/locationLists
Создает новый список местоположений.
get GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}
Получает список местоположений.
list GET /v1/advertisers/{advertiserId}/locationLists
Содержит списки местоположений на основе заданного идентификатора рекламодателя.
patch PATCH /v1/advertisers/{advertiserId}/locationLists/{locationList.locationListId}
Обновляет список местоположений.

Ресурс REST: v1.advertisers.locationLists.assignedLocations

Методы
bulkEdit POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations:bulkEdit
Массовое редактирование нескольких назначений между местоположениями и одного списка местоположений.
create POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Создает назначение между местоположением и списком местоположений.
delete DELETE /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{assignedLocationId}
Удаляет назначение между местоположением и списком местоположений.
list GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Перечисляет местоположения, назначенные в список местоположений.

Ресурс REST: v1.advertisers.manualTriggers .

Методы
activate POST /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}:activate
Активирует ручной триггер.
create POST /v1/advertisers/{manualTrigger.advertiserId}/manualTriggers
Создает новый ручной триггер.
deactivate POST /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}:deactivate
Деактивирует ручной триггер.
get GET /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}
Получает ручной триггер.
list GET /v1/advertisers/{advertiserId}/manualTriggers
Перечисляет ручные триггеры, доступные текущему пользователю для данного идентификатора рекламодателя.
patch PATCH /v1/advertisers/{manualTrigger.advertiserId}/manualTriggers/{manualTrigger.triggerId}
Обновляет ручной триггер.

Ресурс REST: v1.advertisers.negativeKeywordLists

Методы
create POST /v1/advertisers/{advertiserId}/negativeKeywordLists
Создает новый список минус-слов.
delete DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
Удаляет список минус-слов с учетом идентификатора рекламодателя и идентификатора списка минус-слов.
get GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
Получает список минус-слов с учетом идентификатора рекламодателя и идентификатора списка минус-слов.
list GET /v1/advertisers/{advertiserId}/negativeKeywordLists
Содержит списки минус-слов на основе заданного идентификатора рекламодателя.
patch PATCH /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordList.negativeKeywordListId}
Обновляет список минус-слов.

Ресурс REST: v1.advertisers.negativeKeywordLists.negativeKeywords

Методы
bulkEdit POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
Массовое редактирование минус-слов в одном списке минус-слов.
create POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
Создает минус-слово в списке минус-слов.
delete DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords/{keywordValue}
Удаляет минус-слово из списка минус-слов.
list GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
Содержит минус-слова в списке минус-слов.
replace POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:replace
Заменяет все минус-слова в одном списке минус-слов.

Ресурс REST: v1.advertisers.targetingTypes.assignedTargetingOptions .

Методы
create POST /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
Назначает рекламодателю параметр таргетинга.
delete DELETE /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Удаляет назначенный параметр таргетинга у рекламодателя.
get GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Получает один вариант таргетинга, назначенный рекламодателю.
list GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
Перечисляет параметры таргетинга, назначенные рекламодателю.

Ресурс REST: v1.combinedAudiences

Методы
get GET /v1/combinedAudiences/{combinedAudienceId}
Получает объединенную аудиторию.
list GET /v1/combinedAudiences
Перечисляет объединенные аудитории.

Ресурс REST: v1.customBiddingAlgorithms

Методы
create POST /v1/customBiddingAlgorithms
Создает новый специальный алгоритм назначения ставок.
get GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}
Получает собственный алгоритм назначения ставок.
list GET /v1/customBiddingAlgorithms
Перечисляет специальные алгоритмы назначения ставок, которые доступны текущему пользователю и могут использоваться в стратегиях назначения ставок.
patch PATCH /v1/customBiddingAlgorithms/{customBiddingAlgorithm.customBiddingAlgorithmId}
Обновляет существующий алгоритм специального назначения ставок.
uploadScript GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadScript
Создает объект ссылки на сценарий специального назначения ставок для файла сценария.

Ресурс REST: v1.customBiddingAlgorithms.scripts

Методы
create POST /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
Создает новый скрипт специального назначения ставок.
get GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts/{customBiddingScriptId}
Получает специальный сценарий назначения ставок.
list GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
Перечисляет скрипты специального назначения ставок, принадлежащие данному алгоритму.

Ресурс REST: v1.customLists

Методы
get GET /v1/customLists/{customListId}
Получает пользовательский список.
list GET /v1/customLists
Списки пользовательских списков.

Ресурс REST: v1.firstAndThirdPartyAudiences

Методы
create POST /v1/firstAndThirdPartyAudiences
Создает FirstAndThirdPartyAudience.
editCustomerMatchMembers POST /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers
Обновляет список участников аудитории списков электронных адресов.
get GET /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}
Получает первую и стороннюю аудиторию.
list GET /v1/firstAndThirdPartyAudiences
Перечисляет собственную и стороннюю аудитории.
patch PATCH /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId}
Обновляет существующую FirstAndThirdPartyAudience.

Ресурс REST: v1.floodlightGroups

Методы
get GET /v1/floodlightGroups/{floodlightGroupId}
Получает группу Floodlight.
patch PATCH /v1/floodlightGroups/{floodlightGroup.floodlightGroupId}
Обновляет существующую группу Floodlight.

Ресурс REST: v1.googleAudiences .

Методы
get GET /v1/googleAudiences/{googleAudienceId}
Получает аудиторию Google.
list GET /v1/googleAudiences
Перечисляет аудитории Google.

Ресурс REST: v1.guaranteeOrders

Методы
create POST /v1/guaranteedOrders
Создает новый гарантированный заказ.
editGuaranteedOrderReadAccessors POST /v1/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
Правки читают рекламодатели гарантированного заказа.
get GET /v1/guaranteedOrders/{guaranteedOrderId}
Получает гарантированный заказ.
list GET /v1/guaranteedOrders
Перечисляет гарантированные заказы, доступные текущему пользователю.
patch PATCH /v1/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
Обновляет существующий гарантированный заказ.

Ресурс REST: v1.inventorySourceGroups

Методы
create POST /v1/inventorySourceGroups
Создает новую группу источников инвентаря.
delete DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}
Удаляет группу источников инвентаря.
get GET /v1/inventorySourceGroups/{inventorySourceGroupId}
Получает группу источников инвентаря.
list GET /v1/inventorySourceGroups
Перечисляет группы источников инвентаря, доступные текущему пользователю.
patch PATCH /v1/inventorySourceGroups/{inventorySourceGroup.inventorySourceGroupId}
Обновляет группу источников инвентаря.

Ресурс REST: v1.inventorySourceGroups.assignedInventorySources

Методы
bulkEdit POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources:bulkEdit
Массовое редактирование нескольких назначений между источниками инвентаря и одной группой источников инвентаря.
create POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
Создает назначение между источником инвентаря и группой источников инвентаря.
delete DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources/{assignedInventorySourceId}
Удаляет назначение между источником инвентаря и группой источников инвентаря.
list GET /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
Перечисляет источники запасов, назначенные группе источников запасов.

Ресурс REST: v1.inventorySources

Методы
create POST /v1/inventorySources
Создает новый источник инвентаря.
editInventorySourceReadWriteAccessors POST /v1/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors
Редактирует средства доступа для чтения/записи источника инвентаря.
get GET /v1/inventorySources/{inventorySourceId}
Получает источник инвентаря.
list GET /v1/inventorySources
Перечисляет источники инвентаря, доступные текущему пользователю.
patch PATCH /v1/inventorySources/{inventorySource.inventorySourceId}
Обновляет существующий источник инвентаря.

Ресурс REST: v1.media

Методы
download GET /download/{resourceName=**}
Загружает медиа.
upload POST /media/{resourceName=**}
POST /upload/media/{resourceName=**}
Загружает медиа.

Ресурс REST: v1.partners

Методы
bulkEditPartnerAssignedTargetingOptions POST /v1/partners/{partnerId}:bulkEditPartnerAssignedTargetingOptions
Массовое редактирование параметров таргетинга для одного партнера.
get GET /v1/partners/{partnerId}
Получает партнера.
list GET /v1/partners
Перечисляет партнеров, доступных текущему пользователю.

Ресурс REST: v1.partners.channels

Методы
create POST /v1/partners/{partnerId}/channels
Создает новый канал.
get GET /v1/partners/{partnerId}/channels/{channelId}
Получает канал для партнера или рекламодателя.
list GET /v1/partners/{partnerId}/channels
Перечисляет каналы партнера или рекламодателя.
patch PATCH /v1/partners/{partnerId}/channels/{channel.channelId}
Обновляет канал.

Ресурс REST: v1.partners.channels.sites .

Методы
bulkEdit POST /v1/partners/{partnerId}/channels/{channelId}/sites:bulkEdit
Массовое редактирование сайтов в рамках одного канала.
create POST /v1/partners/{partnerId}/channels/{channelId}/sites
Создает сайт в канале.
delete DELETE /v1/partners/{partnerId}/channels/{channelId}/sites/{urlOrAppId}
Удаляет сайт из канала.
list GET /v1/partners/{partnerId}/channels/{channelId}/sites
Перечисляет сайты в канале.
replace POST /v1/partners/{partnerId}/channels/{channelId}/sites:replace
Заменяет все сайты под одним каналом.

Ресурс REST: v1.partners.targetingTypes.assignedTargetingOptions .

Методы
create POST /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
Назначает партнеру параметр таргетинга.
delete DELETE /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Удаляет назначенный параметр таргетинга у партнера.
get GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Получает один вариант таргетинга, назначенный партнеру.
list GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
Перечисляет параметры таргетинга, назначенные партнеру.

Ресурс REST: v1.sdfdownloadtasks

Методы
create POST /v1/sdfdownloadtasks
Создает задачу загрузки SDF.

Ресурс REST: v1.sdfdownloadtasks.operations

Методы
get GET /v1/{name=sdfdownloadtasks/operations/*}
Получает последнее состояние операции задачи асинхронной загрузки SDF.

Ресурс REST: v1.targetingTypes.targetingOptions .

Методы
get GET /v1/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId}
Получает один вариант таргетинга.
list GET /v1/targetingTypes/{targetingType}/targetingOptions
Перечисляет параметры таргетинга данного типа.
search POST /v1/targetingTypes/{targetingType}/targetingOptions:search
Ищет параметры таргетинга заданного типа на основе заданных поисковых запросов.

Ресурс REST: v1.users

Методы
bulkEditAssignedUserRoles POST /v1/users/{userId}:bulkEditAssignedUserRoles
Массовое редактирование ролей для пользователя.
create POST /v1/users
Создает нового пользователя.
delete DELETE /v1/users/{userId}
Удаляет пользователя.
get GET /v1/users/{userId}
Получает пользователя.
list GET /v1/users
Перечисляет пользователей, которые доступны текущему пользователю.
patch PATCH /v1/users/{user.userId}
Обновляет существующего пользователя.