DimensionValues: query

用于检索报表维度值的列表,以获取过滤条件的列表。立即试用

请求

HTTP 请求

POST https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/dimensionvalues/query

参数

参数名称 说明
路径参数
profileId long Campaign Manager 360 用户个人资料 ID。
可选的查询参数
maxResults integer 返回的结果数上限。可接受的值为 0100(含)。(默认值:100
pageToken string 上一结果页中的 nextToken 值。

授权

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

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

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

请求正文

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

{
  "kind": "dfareporting#dimensionValueRequest",
  "dimensionName": string,
  "startDate": date,
  "endDate": date,
  "filters": [
    {
      "kind": "dfareporting#dimensionFilter",
      "dimensionName": string,
      "value": string
    }
  ]
}
属性名称 说明 备注
kind string 表示这是哪类请求,在本例中为 dfareporting#dimensionValueRequest
dimensionName string 表示应为名为什么的维度请求值。 可写入
startDate date 用于检索维度值的日期范围的开始日期。是一个格式为 "yyyy-MM-dd" 的字符串。 可写入
endDate date 用于检索维度值的日期范围的结束日期。是一个格式为 "yyyy-MM-dd" 的字符串。 可写入
filters[] list 用于过滤值的过滤条件的列表。这些过滤条件之间是 AND 关系。 可写入
filters[].kind string 表明这是哪类资源,在本例中为 dfareporting#dimensionFilter
filters[].dimensionName string 要过滤的维度的名称。
filters[].value string 要过滤的维度的值。

响应

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

{
  "kind": "dfareporting#dimensionValueList",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    dimensionValues Resource
  ]
}
属性名称 说明 备注
kind string 表明这是哪类列表,在本例中为 dfareporting#dimensionValueList
etag etag 此响应的 ETag,用于缓存目的。
nextPageToken string 用于分页浏览维度值的连续标记。要检索下一页结果,请将下一个请求的“pageToken”设置为此字段的值。页面标记仅在有限的一段时间内有效,不应持久保留。
items[] list 此响应中返回的维度值。

试试看!

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