Campaign Manager 360 API v3.4 已被弃用,并将于 2022 年 1 月 10 日停用。所有用户都必须在该截止日期之前迁移到新版 API。

Reports: list

用于检索报表的列表。立即试用

请求

HTTP 请求

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

参数

参数名称 说明
路径参数
profileId long Campaign Manager 360 用户个人资料 ID。
可选的查询参数
maxResults integer 返回的结果数上限。可接受的值为 010(含)。(默认值:10
pageToken string 上一结果页中的 nextToken 值。
scope string 用来界定具体返回哪些结果的范围。

可接受的值为:
  • ALL”:帐号中的所有报表。
  • MINE”:我的报表。 (默认)
sortField string 表示要按哪个字段对此列表进行排序。

可接受的值为:
  • ID”:按报表 ID 排序。
  • LAST_MODIFIED_TIME”:按“lastModifiedTime”字段排序。 (默认)
  • NAME”:按报表名称排序。
sortOrder string 结果的排序顺序。

可接受的值为:
  • ASCENDING”:升序。
  • DESCENDING”:降序。(默认)

授权

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

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

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

请求正文

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

响应

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

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

试试看!

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