Display & Video 360 API

Display & Video 360 API 可讓使用者自動化複雜的 Display & Video 360 工作流程，例如建立廣告訂單，以及為個別委刊項設定指定目標選項。

服務：displayvideo.googleapis.com

如要呼叫這項服務，建議您使用 Google 提供的用戶端程式庫。如果您的應用程式需要使用您自己的程式庫來呼叫這項服務，請在發出 API 要求時使用下列資訊。

探索文件

探索文件是一種機器可解讀的規格，用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式，以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件：

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點，且下方的 URI 皆以此服務端點為基準：

  • https://displayvideo.googleapis.com

REST 資源：v3.advertisers

方法
audit GET /v3/advertisers/{advertiserId}:audit
稽核廣告主。
create POST /v3/advertisers
建立新的廣告主。
delete DELETE /v3/advertisers/{advertiserId}
刪除廣告客戶。
editAssignedTargetingOptions POST /v3/advertisers/{advertiserId}:editAssignedTargetingOptions
編輯單一廣告主下的指定目標選項。
get GET /v3/advertisers/{advertiserId}
取得廣告客戶。
list GET /v3/advertisers
列出目前使用者可存取的廣告客戶。
listAssignedTargetingOptions GET /v3/advertisers/{advertiserId}:listAssignedTargetingOptions
列出廣告客戶在不同指定類型中獲派的指定目標選項。
patch PATCH /v3/advertisers/{advertiser.advertiserId}
更新現有廣告客戶。

REST 資源：v3.advertisers.adGroupAds

方法
get GET /v3/advertisers/{advertiserId}/adGroupAds/{adGroupAdId}
取得廣告群組廣告。
list GET /v3/advertisers/{advertiserId}/adGroupAds
列出廣告群組廣告。

REST 資源：v3.advertisers.adGroups

方法
bulkListAdGroupAssignedTargetingOptions GET /v3/advertisers/{advertiserId}/adGroups:bulkListAdGroupAssignedTargetingOptions
列出多個廣告群組在各指定目標類型中指派的指定目標選項。
get GET /v3/advertisers/{advertiserId}/adGroups/{adGroupId}
取得廣告群組。
list GET /v3/advertisers/{advertiserId}/adGroups
列出廣告群組。

REST 資源：v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions

方法
get GET /v3/advertisers/{advertiserId}/adGroups/{adGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
取得指派給廣告群組的單一指定目標選項。
list GET /v3/advertisers/{advertiserId}/adGroups/{adGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions
列出指派給廣告群組的指定目標選項。

REST 資源：v3.advertisers.assets

方法
upload POST /v3/advertisers/{advertiserId}/assets
POST /upload/v3/advertisers/{advertiserId}/assets
上傳素材資源。

REST 資源：v3.advertisers.campaigns

方法
create POST /v3/advertisers/{campaign.advertiserId}/campaigns
建立新的廣告活動。
delete DELETE /v3/advertisers/{advertiserId}/campaigns/{campaignId}
永久刪除廣告活動。
get GET /v3/advertisers/{advertiserId}/campaigns/{campaignId}
取得廣告活動。
list GET /v3/advertisers/{advertiserId}/campaigns
列出廣告主中的廣告活動。
listAssignedTargetingOptions GET /v3/advertisers/{advertiserId}/campaigns/{campaignId}:listAssignedTargetingOptions
列出廣告活動在各指定類型中指派的指定目標選項。
patch PATCH /v3/advertisers/{campaign.advertiserId}/campaigns/{campaign.campaignId}
更新現有廣告活動。

REST 資源：v3.advertisers.campaigns.targetingTypes.assignedTargetingOptions

方法
get GET /v3/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
取得指派給廣告活動的單一指定選項。
list GET /v3/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions
列出指定指定類型時，指派給廣告活動的指定目標對象選項。

REST 資源：v3.advertisers.channels

方法
create POST /v3/advertisers/{advertiserId}/channels
建立新管道。
get GET /v3/advertisers/{advertiserId}/channels/{channelId}
取得合作夥伴或廣告主的頻道。
list GET /v3/advertisers/{advertiserId}/channels
列出夥伴或廣告主的頻道。
patch PATCH /v3/advertisers/{advertiserId}/channels/{channel.channelId}
更新管道。

REST 資源：v3.advertisers.channels.sites

方法
bulkEdit POST /v3/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
在單一管道中大量編輯網站。
create POST /v3/advertisers/{advertiserId}/channels/{channelId}/sites
在頻道中建立網站。
delete DELETE /v3/advertisers/{advertiserId}/channels/{channelId}/sites/{urlOrAppId}
從管道中刪除網站。
list GET /v3/advertisers/{advertiserId}/channels/{channelId}/sites
列出管道中的網站。
replace POST /v3/advertisers/{advertiserId}/channels/{channelId}/sites:replace
替換單一管道下的所有網站。

REST 資源：v3.advertisers.creatives

方法
create POST /v3/advertisers/{creative.advertiserId}/creatives
建立新的廣告素材。
delete DELETE /v3/advertisers/{advertiserId}/creatives/{creativeId}
刪除廣告素材。
get GET /v3/advertisers/{advertiserId}/creatives/{creativeId}
取得廣告素材。
list GET /v3/advertisers/{advertiserId}/creatives
列出廣告客戶的廣告素材。
patch PATCH /v3/advertisers/{creative.advertiserId}/creatives/{creative.creativeId}
更新現有廣告素材。

REST 資源：v3.advertisers.insertionOrders

方法
create POST /v3/advertisers/{insertionOrder.advertiserId}/insertionOrders
建立新的廣告訂單。
delete DELETE /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
刪除廣告訂單。
get GET /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
取得廣告訂單。
list GET /v3/advertisers/{advertiserId}/insertionOrders
列出廣告主中的廣告訂單。
listAssignedTargetingOptions GET /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:listAssignedTargetingOptions
列出廣告訂單在各指定類型中指派的指定目標選項。
patch PATCH /v3/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}
更新現有的廣告訂單。

REST 資源：v3.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

方法
create POST /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
將指定目標選項指派給廣告訂單。
delete DELETE /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
從廣告訂單中刪除已指派的指定目標選項。
get GET /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
取得指派給廣告訂單的單一指定目標選項。
list GET /v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
列出指派給廣告訂單的指定目標選項。

REST 資源：v3.advertisers.invoices

方法
list GET /v3/advertisers/{advertiserId}/invoices
列出廣告客戶在特定月份發布的月結單。
lookupInvoiceCurrency GET /v3/advertisers/{advertiserId}/invoices:lookupInvoiceCurrency
擷取廣告主在特定月份使用的月結單貨幣。

REST 資源：v3.advertisers.lineItems

方法
bulkEditAssignedTargetingOptions POST /v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
大量編輯多個委刊項下的指定目標選項。
bulkListAssignedTargetingOptions GET /v3/advertisers/{advertiserId}/lineItems:bulkListAssignedTargetingOptions
列出不同指定類型中多個委刊項的指派指定目標選項。
bulkUpdate POST /v3/advertisers/{advertiserId}/lineItems:bulkUpdate
更新多個委刊項。
create POST /v3/advertisers/{lineItem.advertiserId}/lineItems
建立新的委刊項。
delete DELETE /v3/advertisers/{advertiserId}/lineItems/{lineItemId}
刪除委刊項。
duplicate POST /v3/advertisers/{advertiserId}/lineItems/{lineItemId}:duplicate
複製委刊項。
generateDefault POST /v3/advertisers/{advertiserId}/lineItems:generateDefault
建立新的委刊項，其中的設定 (包括指定目標) 會繼承自廣告訂單和 ENTITY_STATUS_DRAFT entity_status。
get GET /v3/advertisers/{advertiserId}/lineItems/{lineItemId}
取得委刊項。
list GET /v3/advertisers/{advertiserId}/lineItems
列出廣告主中的委刊項。
patch PATCH /v3/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}
更新現有的委刊項。

REST 資源：v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions

方法
create POST /v3/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
將指定選項指派給委刊項。
delete DELETE /v3/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
從委刊項中刪除已指派的指定目標選項。
get GET /v3/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
取得指派給委刊項的單一指定目標選項。
list GET /v3/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
列出指派給委刊項的指定目標選項。

REST 資源：v3.advertisers.locationLists

方法
create POST /v3/advertisers/{advertiserId}/locationLists
建立新的地點清單。
get GET /v3/advertisers/{advertiserId}/locationLists/{locationListId}
取得位置清單。
list GET /v3/advertisers/{advertiserId}/locationLists
根據指定的廣告主 ID 列出位置清單。
patch PATCH /v3/advertisers/{advertiserId}/locationLists/{locationList.locationListId}
更新地點清單。

REST 資源：v3.advertisers.locationLists.assignedLocations

方法
bulkEdit POST /v3/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations:bulkEdit
大量編輯地點和單一地點清單之間的多個指派。
create POST /v3/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
在位置和位置清單之間建立指派。
delete DELETE /v3/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{assignedLocationId}
刪除位置與位置清單之間的指派作業。
list GET /v3/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
列出指派給地點清單的地點。

REST 資源：v3.advertisers.negativeKeywordLists

方法
create POST /v3/advertisers/{advertiserId}/negativeKeywordLists
建立新的排除關鍵字清單。
delete DELETE /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
根據廣告主 ID 和排除關鍵字清單 ID 刪除排除關鍵字清單。
get GET /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
根據廣告主 ID 和排除關鍵字清單 ID，取得排除關鍵字清單。
list GET /v3/advertisers/{advertiserId}/negativeKeywordLists
根據指定廣告主 ID 列出排除關鍵字清單。
patch PATCH /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordList.negativeKeywordListId}
更新排除關鍵字清單。

REST 資源：v3.advertisers.negativeKeywordLists.negativeKeywords

方法
bulkEdit POST /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
大量編輯單一排除關鍵字清單中的排除關鍵字。
create POST /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
在排除關鍵字清單中建立排除關鍵字。
delete DELETE /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords/{keywordValue}
從排除關鍵字清單中刪除排除關鍵字。
list GET /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
列出排除關鍵字清單中的排除關鍵字。
replace POST /v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:replace
取代單一排除關鍵字清單中的所有排除關鍵字。

REST 資源：v3.advertisers.targetingTypes.assignedTargetingOptions

方法
create POST /v3/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
將指定選項指派給廣告主。
delete DELETE /v3/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
刪除廣告客戶指派的指定目標選項。
get GET /v3/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
取得指派給廣告主的單一指定目標選項。
list GET /v3/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
列出指派給廣告主的指定目標選項。

REST 資源：v3.combinedAudiences

方法
get GET /v3/combinedAudiences/{combinedAudienceId}
取得合併目標對象。
list GET /v3/combinedAudiences
列出合併目標對象。

REST 資源：v3.customBiddingAlgorithms

方法
create POST /v3/customBiddingAlgorithms
建立新的自訂出價演算法。
get GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}
取得自訂出價演算法。
list GET /v3/customBiddingAlgorithms
列出目前使用者可存取，且可用於出價策略的自訂出價演算法。
patch PATCH /v3/customBiddingAlgorithms/{customBiddingAlgorithm.customBiddingAlgorithmId}
更新現有的自訂出價演算法。
uploadRules GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadRules
為 AlgorithmRules 檔案建立規則參照物件。
uploadScript GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadScript
為指令碼檔案建立自訂出價指令碼參考物件。

REST 資源：v3.customBiddingAlgorithms.rules

方法
create POST /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
建立新的規則資源。
get GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules/{customBiddingAlgorithmRulesId}
擷取規則資源。
list GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
列出屬於指定演算法的規則資源。

REST 資源：v3.customBiddingAlgorithms.scripts

方法
create POST /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
建立新的自訂出價指令碼。
get GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts/{customBiddingScriptId}
取得自訂出價指令碼。
list GET /v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
列出屬於指定演算法的自訂出價指令碼。

REST 資源：v3.customLists

方法
get GET /v3/customLists/{customListId}
取得自訂清單。
list GET /v3/customLists
列出自訂名單。

REST 資源：v3.firstAndThirdPartyAudiences

方法
create POST /v3/firstAndThirdPartyAudiences
建立 FirstAndThirdPartyAudience。
editCustomerMatchMembers POST /v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers
更新目標顧客比對目標對象的成員清單。
get GET /v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}
取得第一方和第三方目標對象。
list GET /v3/firstAndThirdPartyAudiences
列出第一方和第三方目標對象。
patch PATCH /v3/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId}
更新現有的 FirstAndThirdPartyAudience。

REST 資源：v3.floodlightGroups

方法
get GET /v3/floodlightGroups/{floodlightGroupId}
取得 Floodlight 群組。
patch PATCH /v3/floodlightGroups/{floodlightGroup.floodlightGroupId}
更新現有的 Floodlight 群組。

REST 資源：v3.floodlightGroups.floodlightActivities

方法
get GET /v3/floodlightGroups/{floodlightGroupId}/floodlightActivities/{floodlightActivityId}
取得 Floodlight 活動。
list GET /v3/floodlightGroups/{floodlightGroupId}/floodlightActivities
列出 Floodlight 群組中的 Floodlight 活動。

REST 資源：v3.googleAudiences

方法
get GET /v3/googleAudiences/{googleAudienceId}
取得 Google 目標對象。
list GET /v3/googleAudiences
列出 Google 目標對象。

REST 資源：v3.guaranteedOrders

方法
create POST /v3/guaranteedOrders
建立新的保證交易訂單。
editGuaranteedOrderReadAccessors POST /v3/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
編輯保證訂單的讀取廣告主。
get GET /v3/guaranteedOrders/{guaranteedOrderId}
取得保證交易訂單。
list GET /v3/guaranteedOrders
列出目前使用者可存取的保證訂單。
patch PATCH /v3/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
更新現有的保證訂單。

REST 資源：v3.inventorySourceGroups

方法
create POST /v3/inventorySourceGroups
建立新的廣告空間來源群組。
delete DELETE /v3/inventorySourceGroups/{inventorySourceGroupId}
刪除廣告空間來源群組。
get GET /v3/inventorySourceGroups/{inventorySourceGroupId}
取得廣告空間來源群組。
list GET /v3/inventorySourceGroups
列出目前使用者可存取的廣告空間來源群組。
patch PATCH /v3/inventorySourceGroups/{inventorySourceGroup.inventorySourceGroupId}
更新廣告空間來源群組。

REST 資源：v3.inventorySourceGroups.assignedInventorySources

方法
bulkEdit POST /v3/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources:bulkEdit
大量編輯廣告空間來源和單一廣告空間來源群組之間的多個指派項目。
create POST /v3/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
在廣告空間來源和廣告空間來源群組之間建立指派。
delete DELETE /v3/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources/{assignedInventorySourceId}
刪除廣告空間來源與廣告空間來源群組之間的指定項目。
list GET /v3/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
列出指派給廣告空間來源群組的廣告空間來源。

REST 資源：v3.inventorySources

方法
create POST /v3/inventorySources
建立新的廣告空間來源。
editInventorySourceReadWriteAccessors POST /v3/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors
編輯廣告空間來源的讀取/寫入存取子。
get GET /v3/inventorySources/{inventorySourceId}
取得廣告空間來源。
list GET /v3/inventorySources
列出目前使用者可存取的廣告空間來源。
patch PATCH /v3/inventorySources/{inventorySource.inventorySourceId}
更新現有的廣告空間來源。

REST 資源：v3.media

方法
download GET /download/{resourceName=**}
下載媒體。
upload POST /media/{resourceName=**}
POST /upload/media/{resourceName=**}
上傳媒體。

REST 資源：v3.partners

方法
editAssignedTargetingOptions POST /v3/partners/{partnerId}:editAssignedTargetingOptions
編輯單一合作夥伴下的指定選項。
get GET /v3/partners/{partnerId}
取得合作夥伴。
list GET /v3/partners
列出目前使用者可存取的合作夥伴。

REST 資源：v3.partners.channels

方法
create POST /v3/partners/{partnerId}/channels
建立新管道。
get GET /v3/partners/{partnerId}/channels/{channelId}
取得合作夥伴或廣告主的頻道。
list GET /v3/partners/{partnerId}/channels
列出夥伴或廣告主的頻道。
patch PATCH /v3/partners/{partnerId}/channels/{channel.channelId}
更新管道。

REST 資源：v3.partners.channels.sites

方法
bulkEdit POST /v3/partners/{partnerId}/channels/{channelId}/sites:bulkEdit
在單一管道中大量編輯網站。
create POST /v3/partners/{partnerId}/channels/{channelId}/sites
在管道中建立網站。
delete DELETE /v3/partners/{partnerId}/channels/{channelId}/sites/{urlOrAppId}
從管道中刪除網站。
list GET /v3/partners/{partnerId}/channels/{channelId}/sites
列出管道中的網站。
replace POST /v3/partners/{partnerId}/channels/{channelId}/sites:replace
取代單一管道中的所有網站。

REST 資源：v3.partners.targetingTypes.assignedTargetingOptions

方法
create POST /v3/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
為合作夥伴指派指定目標選項。
delete DELETE /v3/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
刪除合作夥伴的指定指定目標選項。
get GET /v3/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
取得指派給合作夥伴的單一指定選項。
list GET /v3/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
列出指派給合作夥伴的指定目標選項。

REST 資源：v3.sdfdownloadtasks

方法
create POST /v3/sdfdownloadtasks
建立結構化資料檔案下載工作。

REST 資源：v3.sdfdownloadtasks.operations

方法
get GET /v3/{name=sdfdownloadtasks/operations/*}
取得非同步 SDF 下載工作作業的最新狀態。

REST 資源：v3.targetingTypes.targetingOptions

方法
get GET /v3/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId}
取得單一指定選項。
list GET /v3/targetingTypes/{targetingType}/targetingOptions
列出指定類型的指定目標選項。
search POST /v3/targetingTypes/{targetingType}/targetingOptions:search
根據指定的搜尋字詞，搜尋特定類型的指定選項。

REST 資源：v3.users

方法
bulkEditAssignedUserRoles POST /v3/users/{userId}:bulkEditAssignedUserRoles
為使用者大量編輯使用者角色。
create POST /v3/users
建立新使用者。
delete DELETE /v3/users/{userId}
刪除使用者。
get GET /v3/users/{userId}
取得使用者。
list GET /v3/users
列出目前使用者可存取的使用者。
patch PATCH /v3/users/{user.userId}
更新現有使用者。