Creatives: list

检索广告素材列表,可能是过滤后的。此方法支持分页立即试用

请求

HTTP 请求

GET https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/creatives

参数

参数名称 说明
路径参数
profileId long 与此请求相关联的用户个人资料 ID。
可选查询参数
active boolean 仅选择有效广告素材。留空可同时选择有效广告素材和无效广告素材。
advertiserId long 仅选择具有此广告客户 ID 的广告素材。
archived boolean 仅选择已归档的广告素材。留空可同时选择已归档的广告素材和未归档的广告素材。
campaignId long 仅选择具有此广告系列 ID 的广告素材。
companionCreativeIds long 仅选择具有这些随播广告 ID 的插播视频广告素材。
creativeFieldIds long 仅选择具有这些广告素材字段 ID 的广告素材。
ids long 仅选择具有这些 ID 的广告素材。
maxResults integer 返回的结果数上限。 可接受的值介于 0(含)到 1000(含)之间。(默认值:1000
pageToken string 上一结果页中的 nextPageToken 值。
renderingIds long 仅选择具有这些呈现 ID 的广告素材。
searchString string 允许按名称或 ID 搜索对象。允许使用通配符 (*)。例如,搜索 "creative*2015" 将返回名称为 "creative June 2015""creative April 2015" 或只是 "creative 2015" 等的对象。大多数搜索查询也会在搜索字符串的开头和结尾处隐式添加通配符。例如,如果搜索字符串为 "creative",将与名称为 "my creative""creative 2015" 或只是 "creative" 的对象匹配。
sizeIds long 仅选择具有这些尺寸 ID 的广告素材。
sortField string 列表排序所依据的字段。

可接受的值为:
  • ID”(默认值)
  • NAME
sortOrder string 结果的排序顺序。

可接受的值为:
  • ASCENDING”(默认值)
  • DESCENDING
studioCreativeId long 仅选择与此 Studio 广告素材 ID 对应的广告素材。
types string 仅选择属于这些广告素材类型的广告素材。

可接受的值为:
  • BRAND_SAFE_DEFAULT_INSTREAM_VIDEO
  • CUSTOM_DISPLAY
  • CUSTOM_DISPLAY_INTERSTITIAL
  • DISPLAY
  • DISPLAY_IMAGE_GALLERY
  • DISPLAY_REDIRECT
  • FLASH_INPAGE
  • HTML5_BANNER
  • IMAGE
  • INSTREAM_AUDIO
  • INSTREAM_VIDEO
  • INSTREAM_VIDEO_REDIRECT
  • INTERNAL_REDIRECT
  • INTERSTITIAL_INTERNAL_REDIRECT
  • RICH_MEDIA_DISPLAY_BANNER
  • RICH_MEDIA_DISPLAY_EXPANDING
  • RICH_MEDIA_DISPLAY_INTERSTITIAL
  • RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL
  • RICH_MEDIA_IM_EXPAND
  • RICH_MEDIA_INPAGE_FLOATING
  • RICH_MEDIA_MOBILE_IN_APP
  • RICH_MEDIA_PEEL_DOWN
  • TRACKING_TEXT
  • VPAID_LINEAR_VIDEO
  • VPAID_NON_LINEAR_VIDEO

授权

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

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

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

请求正文

请勿使用此方法提供请求正文。

响应

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

{
  "kind": "dfareporting#creativesListResponse",
  "nextPageToken": string,
  "creatives": [
    creatives Resource
  ]
}
属性名称 说明 备注
kind string 标识所属资源种类。值:固定字符串 "dfareporting#creativesListResponse"
nextPageToken string 要用于下一项列出操作的分页令牌。
creatives[] list 广告素材集合。

试试看!

使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。