Placements: list

检索展示位置列表,可能是过滤后的。此方法支持分页立即试用

请求

HTTP 请求

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

参数

参数名称 说明
路径参数
profileId long 与此请求相关联的用户个人资料 ID。
可选查询参数
advertiserIds long 仅选择属于这些广告客户的展示位置。
archived boolean 仅选择已归档的展示位置。请勿将该字段设为同时选择已归档的展示位置和未归档的展示位置。
campaignIds long 仅选择属于这些广告系列的展示位置。
compatibilities string 仅选择与这些兼容性相关联的展示位置。DISPLAYDISPLAY_INTERSTITIAL 分别是指常规广告或插页式广告在桌面设备或移动设备上的呈现。APPAPP_INTERSTITIAL 是指在移动应用中的呈现。IN_STREAM_VIDEO 是指在采用 VAST 标准制作的插播视频广告中的呈现。

可接受的值为:
  • APP
  • APP_INTERSTITIAL
  • DISPLAY
  • DISPLAY_INTERSTITIAL
  • IN_STREAM_AUDIO
  • IN_STREAM_VIDEO
contentCategoryIds long 仅选择与这些内容分类相关联的展示位置。
directorySiteIds long 仅选择与这些目录网站相关联的展示位置。
groupIds long 仅选择属于这些展示位置组的展示位置。
ids long 仅选择具有这些 ID 的展示位置。
maxEndDate string 仅选择结束日期不晚于指定 maxEndDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
maxResults integer 返回的结果数上限。可接受的值介于 0(含)到 1000(含)之间。(默认值:1000
maxStartDate string 仅选择开始日期不晚于指定 maxStartDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
minEndDate string 仅选择结束日期不早于指定 minEndDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
minStartDate string 仅选择开始日期不早于指定 minStartDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
pageToken string 上一结果页中的 nextPageToken 值。
paymentSource string 仅选择此付款来源的展示位置。

可接受的值为:
  • PLACEMENT_AGENCY_PAID
  • PLACEMENT_PUBLISHER_PAID
placementStrategyIds long 仅选择与这些展示位置策略相关联的展示位置。
pricingTypes string 仅选择采用这些定价类型的展示位置。

可接受的值为:
  • PRICING_TYPE_CPA
  • PRICING_TYPE_CPC
  • PRICING_TYPE_CPM
  • PRICING_TYPE_CPM_ACTIVEVIEW
  • PRICING_TYPE_FLAT_RATE_CLICKS
  • PRICING_TYPE_FLAT_RATE_IMPRESSIONS
searchString string 允许按名称或 ID 搜索展示位置。允许使用通配符 (*)。例如,搜索 "placement*2015" 将返回名称为 "placement June 2015""placement May 2015" 或只是 "placements 2015" 等的展示位置。大多数搜索查询也会在搜索字符串的开头和结尾处隐式添加通配符。例如,如果搜索字符串为 "placement",将与名称为 "my placement""placement 2015" 或只是 "placement" 的展示位置匹配。
siteIds long 仅选择与这些网站相关联的展示位置。
sizeIds long 仅选择与这些尺寸相关联的展示位置。
sortField string 列表排序所依据的字段。

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

可接受的值为:
  • ASCENDING”(默认值)
  • DESCENDING

授权

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

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

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

请求正文

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

响应

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

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

试试看!

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