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
创建 SDF 下载任务。

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}
更新现有用户。