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