DV360 Out of Home Seller API

借助 DV360 Out of Home Seller API，您可以管理广告资源、预订订单、获取广告素材和提交广告播放事件。

服务：dv360outofhomeseller.googleapis.com

要调用此服务，我们建议您使用 Google 提供的客户端库。如果您的应用程序需要使用自己的库来调用此服务，请在发出 API 请求时使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档：

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点，下面的所有 URI 都与此服务端点相关：

  • https://dv360outofhomeseller.googleapis.com

REST 资源：v1beta1

方法
lookupByExternalId POST /v1beta1:lookupByExternalId
按请求中列出的外部 ID 检索所有实体。

REST 资源：v1beta1.adPlays

方法
create POST /v1beta1/adPlays
创建广告播放。
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
使用外部 ID 创建广告播放。

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/*}
更新现有商品。