PlacementGroups: list

检索展示位置组列表,该列表可能经过了过滤。此方法支持分页立即试用

请求

HTTP 请求

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

参数

参数名称 说明
路径参数
profileId long 与此请求相关联的用户个人资料 ID。
可选查询参数
advertiserIds long 仅选择属于这些广告客户的展示位置组。
archived boolean 仅选择已归档的展示位置。请勿将该字段设为同时选择已归档的展示位置和未归档的展示位置。
campaignIds long 仅选择属于这些广告系列的展示位置组。
contentCategoryIds long 仅选择与这些内容分类相关联的展示位置组。
directorySiteIds long 仅选择与这些目录网站相关联的展示位置组。
ids long 仅选择具有这些 ID 的展示位置组。
maxEndDate string 仅选择结束日期不晚于指定 maxEndDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
maxResults integer 返回的结果数上限。可接受的值介于 0(含)到 800(含)之间。(默认值:800
maxStartDate string 仅选择开始日期不晚于指定 maxStartDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
minEndDate string 仅选择结束日期不早于指定 minEndDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
minStartDate string 仅选择开始日期不早于指定 minStartDate 的展示位置或展示位置组。日期应该采用“yyyy-MM-dd”格式。
pageToken string 上一结果页中的 nextPageToken 值。
placementGroupType string 仅选择属于此组类型的展示位置组。打包是一个简单的展示位置组,可作为一组代码的单个价位。包版是一个展示位置组,不仅可以作为单个价位,还会假设其中的所有代码同时投放。包版要求将所分配的一个展示位置标记为主要展示位置来生成报表。

可接受的值为:
  • PLACEMENT_PACKAGE
  • PLACEMENT_ROADBLOCK
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 group June 2015""placement group May 2015" 或只是 "placements 2015" 等的展示位置组。大多数搜索查询也会在搜索字符串的开头和结尾处隐式添加通配符。例如,如果搜索字符串为 "placementgroup",将与名称为 "my placementgroup""placementgroup 2015" 或只是 "placementgroup" 的展示位置组匹配。
siteIds long 仅选择与这些网站相关联的展示位置组。
sortField string 列表排序所依据的字段。

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

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

授权

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

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

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

请求正文

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

响应

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

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

试试看!

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