Sdf: download

检索 SDF 格式的实体。 立即试用

请求

HTTP 请求

POST https://www.googleapis.com/doubleclickbidmanager/v1.1/sdf/download

授权

此请求需要获得以下范围的授权:

范围
https://www.googleapis.com/auth/doubleclickbidmanager

如需了解详情,请参阅身份验证和授权页面。

请求正文

在请求正文中,请按以下结构提供数据:

{
 
"fileTypes": [
   
string
 
],
 
"filterType": string,
 
"filterIds": [
   
long
 
],
 
"version": string
}
属性名称 说明 备注
fileTypes[] list 将返回的文件类型。如果请求了 INVENTORY_SOURCE,则不得请求其他文件类型。

可接受的值包括:
  • AD
  • AD_GROUP
  • CAMPAIGN
  • INSERTION_ORDER
  • INVENTORY_SOURCE
  • LINE_ITEM
filterType string 用于过滤要提取的实体的过滤条件类型。PARTNER_ID 和 INVENTORY_SOURCE_ID 只能在下载广告资源来源时使用。

可接受的值包括:
  • ADVERTISER_ID
  • CAMPAIGN_ID
  • INSERTION_ORDER_ID
  • INVENTORY_SOURCE_ID
  • LINE_ITEM_ID
  • PARTNER_ID
filterIds[] list 指定过滤器类型的 ID。这用于过滤要提取的实体。必须至少指定一个 ID。对于“ADVERTISER_ID”过滤条件类型,只能使用一个 ID。对于 INSERTION_ORDER_IDLINE_ITEM_ID 过滤条件类型,所有 ID 都必须来自同一广告客户。
version string 返回实体的 SDF 版本(列名称、类型、顺序)。默认为 5.3

响应

如果成功,此方法将返回采用以下结构的响应正文:

{
 
"campaigns": string,
 
"insertionOrders": string,
 
"lineItems": string,
 
"adGroups": string,
 
"ads": string,
 
"inventorySources": string
}
属性名称 说明 备注
insertionOrders string 检索了 SDF 格式的广告订单。
lineItems string 检索 SDF 格式的订单项。
adGroups string 检索到的广告组(采用 SDF 格式)。
ads string 检索到的广告(采用 SDF 格式)。
campaigns string 检索到的广告系列(采用 SDF 格式)。
inventorySources string