DimensionValues: query

注意：需要授权。

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

请求

HTTP 请求

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

参数

参数名称	值	说明
路径参数
profileId	long	Campaign Manager 360 用户个人资料 ID。
可选的查询参数
maxResults	integer	返回的结果数上限。可接受的值为 0 到 100（含）。（默认值：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 对实际数据调用此方法，然后查看响应。