DV360 Out of Home Seller API

API DV360 Out of Home Seller позволяет управлять запасами, бронировать заказы, получать креативы и отправлять события воспроизведения рекламы.

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

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

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

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

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

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

  • https://dv360outofhomeseller.googleapis.com

Ресурс REST: v1beta1

Методы
lookupByExternalId POST /v1beta1:lookupByExternalId
Получает все объекты по внешнему идентификатору, указанному в запросе.

Ресурс REST: v1beta1.adPlays

Методы
create POST /v1beta1/adPlays
Создает рекламную игру.
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
Создает рекламную игру с внешними идентификаторами.

Ресурс REST: v1beta1.adUnits .

Методы
create POST /v1beta1/adUnits
Создает новый рекламный блок.
delete DELETE /v1beta1/{name=adUnits/*}
Удаляет существующий рекламный блок.
get GET /v1beta1/{name=adUnits/*}
Получает отдельный рекламный блок.
list GET /v1beta1/adUnits
Перечисляет рекламные блоки.
patch PATCH /v1beta1/{adUnit.name=adUnits/*}
Обновляет существующий рекламный блок.

Ресурс REST: v1beta1.availabilityOrders

Методы
complete POST /v1beta1/{name=availabilityOrders/*}:complete
Помечает существующий заказ доступности как завершенный.
get GET /v1beta1/{name=availabilityOrders/*}
Получает индивидуальный заказ доступности.
list GET /v1beta1/availabilityOrders
Список заказов на доступность.

Ресурс REST: v1beta1.availabilityOrders.availabilityLines

Методы
complete POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:complete
Отмечает существующую строку доступности как завершенную.
get GET /v1beta1/{name=availabilityOrders/*/availabilityLines/*}
Извлекает отдельную строку для заказа доступности.
list GET /v1beta1/{parent=availabilityOrders/*}/availabilityLines
Перечисляет строки для заказа доступности.
reject POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:reject
Отмечает существующую строку доступности как отклоненную.

Ресурс REST: v1beta1.creativeAssets

Методы
get GET /v1beta1/{name=creativeAssets/*}
Получает отдельный творческий ресурс.
list GET /v1beta1/creativeAssets
Перечисляет творческие ресурсы.
patch PATCH /v1beta1/{creativeAsset.name=creativeAssets/*}
Обновляет существующий творческий ресурс.

Ресурс REST: v1beta1.orders

Методы
get GET /v1beta1/{name=orders/*}
Получает индивидуальный заказ.
list GET /v1beta1/orders
Перечисляет заказы.
patch PATCH /v1beta1/{order.name=orders/*}
Обновляет существующий заказ.

Ресурс REST: v1beta1.orders.lines

Методы
book POST /v1beta1/{name=orders/*/lines/*}:book
Бронирует существующую линию.
get GET /v1beta1/{name=orders/*/lines/*}
Получает отдельную строку для заказа.
list GET /v1beta1/{parent=orders/*}/lines
Перечисляет строки для заказа.
patch PATCH /v1beta1/{line.name=orders/*/lines/*}
Обновляет существующую строку.
reject POST /v1beta1/{name=orders/*/lines/*}:reject
Отклоняет существующую строку.
reserve POST /v1beta1/{name=orders/*/lines/*}:reserve
Резервирует существующую линию.

Ресурс REST: v1beta1.orders.lines.assignments

Методы
approve POST /v1beta1/{name=orders/*/lines/*/assignments/*}:approve
Утверждает существующее задание.
disapprove POST /v1beta1/{name=orders/*/lines/*/assignments/*}:disapprove
Отклоняет существующее задание.
get GET /v1beta1/{name=orders/*/lines/*/assignments/*}
Получает индивидуальное назначение для строки.
list GET /v1beta1/{parent=orders/*/lines/*}/assignments
Перечисляет назначения для линии.
patch PATCH /v1beta1/{assignment.name=orders/*/lines/*/assignments/*}
Обновляет существующее задание.

Ресурс REST: v1beta1.products

Методы
create POST /v1beta1/products
Создает новый продукт.
get GET /v1beta1/{name=products/*}
Получает отдельный продукт.
list GET /v1beta1/products
Перечисляет продукты.
patch PATCH /v1beta1/{product.name=products/*}
Обновляет существующий продукт.

Ресурс REST: v1.sellers.adPlays

Методы
batchCreate POST /v1/{parent=sellers/*}/adPlays:batchCreate
Пакетно создает новые рекламные ролики.
create POST /v1/{parent=sellers/*}/adPlays
Создает рекламную игру.

Ресурс REST: v1.sellers.adUnits .

Методы
create POST /v1/{parent=sellers/*}/adUnits
Создает новый рекламный блок.
delete DELETE /v1/{name=sellers/*/adUnits/*}
Удаляет существующий рекламный блок.
get GET /v1/{name=sellers/*/adUnits/*}
Получает отдельный рекламный блок.
list GET /v1/{parent=sellers/*}/adUnits
Перечисляет рекламные блоки.
patch PATCH /v1/{adUnit.name=sellers/*/adUnits/*}
Обновляет существующий рекламный блок.

Ресурс REST: v1.sellers.adUnits.impressionSchedules .

Методы
batchUpdate POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate
Обновляет графики показов в пакетном режиме.
create POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Создает новый график показов.
get GET /v1/{name=sellers/*/adUnits/*/impressionSchedules/*}
Получает индивидуальный график показов.
list GET /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Содержит графики показов.
patch PATCH /v1/{impressionSchedule.name=sellers/*/adUnits/*/impressionSchedules/*}
Обновляет существующий график показов.

Ресурс REST: v1.sellers.availabilityOrders

Методы
complete POST /v1/{name=sellers/*/availabilityOrders/*}:complete
Помечает существующий заказ доступности как завершенный.
get GET /v1/{name=sellers/*/availabilityOrders/*}
Получает индивидуальный заказ доступности.
list GET /v1/{parent=sellers/*}/availabilityOrders
Список заказов на доступность.

Ресурс REST: v1.sellers.availabilityOrders.availabilityLines

Методы
complete POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:complete
Отмечает существующую строку доступности как завершенную.
get GET /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}
Извлекает отдельную строку для заказа доступности.
list GET /v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines
Перечисляет строки для заказа доступности.
reject POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:reject
Отмечает существующую строку доступности как отклоненную.

Ресурс REST: v1.sellers.creativeAssets

Методы
get GET /v1/{name=sellers/*/creativeAssets/*}
Получает отдельный творческий ресурс.
list GET /v1/{parent=sellers/*}/creativeAssets
Перечисляет творческие ресурсы.
patch PATCH /v1/{creativeAsset.name=sellers/*/creativeAssets/*}
Обновляет существующий творческий ресурс.

Ресурс REST: v1.sellers.orders

Методы
completeOrderBooking POST /v1/{order=sellers/*/orders/*}:completeOrderBooking
Завершает бронирование заказа.
completeOrderReservation POST /v1/{order=sellers/*/orders/*}:completeOrderReservation
Завершает резервирование заказа.
create POST /v1/{parent=sellers/*}/orders
Создает новый заказ.
get GET /v1/{name=sellers/*/orders/*}
Получает индивидуальный заказ.
list GET /v1/{parent=sellers/*}/orders
Перечисляет заказы.
patch PATCH /v1/{order.name=sellers/*/orders/*}
Обновляет существующий заказ.

Ресурс REST: v1.sellers.orders.lines

Методы
book POST /v1/{name=sellers/*/orders/*/lines/*}:book
Бронирует существующую линию.
create POST /v1/{parent=sellers/*/orders/*}/lines
Создает новую строку.
get GET /v1/{name=sellers/*/orders/*/lines/*}
Получает отдельную строку для заказа.
list GET /v1/{parent=sellers/*/orders/*}/lines
Перечисляет строки для заказа.
patch PATCH /v1/{line.name=sellers/*/orders/*/lines/*}
Обновляет существующую строку.
reject POST /v1/{name=sellers/*/orders/*/lines/*}:reject
Отклоняет существующую строку.
reserve POST /v1/{name=sellers/*/orders/*/lines/*}:reserve
Резервирует существующую линию.

Ресурс REST: v1.sellers.orders.lines.assignments

Методы
approve POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:approve
Утверждает существующее задание.
disapprove POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:disapprove
Отклоняет существующее задание.
get GET /v1/{name=sellers/*/orders/*/lines/*/assignments/*}
Получает индивидуальное назначение для строки.
list GET /v1/{parent=sellers/*/orders/*/lines/*}/assignments
Перечисляет назначения для линии.
patch PATCH /v1/{assignment.name=sellers/*/orders/*/lines/*/assignments/*}
Обновляет существующее задание.

Ресурс REST: v1.sellers.products

Методы
create POST /v1/{parent=sellers/*}/products
Создает новый продукт.
delete DELETE /v1/{name=sellers/*/products/*}
Удаляет существующий продукт.
get GET /v1/{name=sellers/*/products/*}
Получает отдельный продукт.
list GET /v1/{parent=sellers/*}/products
Перечисляет продукты.
patch PATCH /v1/{product.name=sellers/*/products/*}
Обновляет существующий продукт.