Reports: update

更新报表。立即试用

请求

HTTP 请求

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

参数

参数名称 说明
路径参数
profileId long Campaign Manager 360 用户个人资料 ID。
reportId long 报表的 ID。

授权

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

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

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

请求正文

在请求正文中,提供具有以下属性的 Report 资源

属性名称 说明 备注
必需属性
accountId long 此报表所属的帐号 ID。
delivery.recipients[].deliveryType string 供收件人接收报表的递送类型。

可接受的值包括:
  • ATTACHMENT
  • LINK
可写入
delivery.recipients[].email string 收件人的电子邮件地址。 可写入
id long 用于标识此报表资源的唯一 ID。
lastModifiedTime unsigned long 此报表最后一次修改的时间戳(单位为毫秒,自纪元开始的时间算起)。
name string 报表的名称。 可写入
ownerProfileId long 此报表所有者的用户个人资料 ID。
schedule.active boolean 时间安排是否有效。必须设为 true 或 false。 可写入
schedule.expirationDate date 此定期报表生成作业停止运行的到期日期。 可写入
schedule.repeats string 此报表生成作业运行的时间间隔。注意:
  • “DAILY”,同时需要设置“every”字段。
  • “WEEKLY”,同时需要设置“every”和“repeatsOnWeekDays”字段。
  • “MONTHLY”,同时需要设置“every”和“runsOnDayOfMonth”字段。
可写入
schedule.startDate date 定期报表生成作业的日期范围的开始日期。 可写入
type string 报表类型。

可接受的值包括:
  • CROSS_DIMENSION_REACH
  • FLOODLIGHT
  • PATH
  • PATH_ATTRIBUTION
  • PATH_TO_CONVERSION
  • REACH
  • STANDARD
可选属性
criteria.activities.filters[] list 活动过滤器列表。所有维度值都必须是“dfa:activity”类型或者是“dfa:activityGroup”类型。 可写入
criteria.customRichMediaEvents.filteredEventIds[] list 自定义 Rich Media 事件 ID 列表。所有维度值都必须是“dfa:richMediaEventTypeIdAndName”类型。 可写入
criteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
criteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
criteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
criteria.dimensionFilters[] list 用来对维度进行过滤的过滤器列表。

不同维度的过滤器之间为 AND 关系;同一个维度的多个过滤器归为一组,彼此之间的关系为 OR。

可写入
criteria.dimensions[] list 报表应包含的标准维度列表。 可写入
criteria.metricNames[] list 报表应包含的指标名称列表。 可写入
crossDimensionReachCriteria object “CROSS_DIMENSION_REACH”类型的报表的报表条件。 可写入
crossDimensionReachCriteria.breakdown[] list 报表应包含的维度列表。 可写入
crossDimensionReachCriteria.dateRange nested object 应生成此报表的日期范围。 可写入
crossDimensionReachCriteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
crossDimensionReachCriteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
crossDimensionReachCriteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
crossDimensionReachCriteria.dimension string 维度选项。

可接受的值包括:
  • ADVERTISER
  • CAMPAIGN
  • SITE_BY_ADVERTISER
  • SITE_BY_CAMPAIGN
可写入
crossDimensionReachCriteria.dimensionFilters[] list 用来对维度进行过滤的过滤器列表。 可写入
crossDimensionReachCriteria.metricNames[] list 报表应包含的指标名称列表。 可写入
crossDimensionReachCriteria.overlapMetricNames[] list 报表应包含的重叠指标名称列表。 可写入
crossDimensionReachCriteria.pivoted boolean 是否为透视报表。默认为 true。 可写入
delivery object 报表的电子邮件递送设置。 可写入
delivery.emailOwner boolean 是否应通过电子邮件将报表发送给报表所有者。 可写入
delivery.emailOwnerDeliveryType string 供所有者接收报表的递送类型(如果已启用)。

可接受的值包括:
  • ATTACHMENT
  • LINK
可写入
delivery.message string 要随每封电子邮件发送的信息。 可写入
delivery.recipients[] list 通过电子邮件发送的报表的收件人列表。 可写入
fileName string 为此报表生成报表文件时使用的文件名。 可写入
floodlightCriteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
floodlightCriteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
floodlightCriteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
floodlightCriteria.dimensionFilters[] list 用来对维度进行过滤的过滤器列表。

不同维度的过滤器之间为 AND 关系;同一个维度的多个过滤器归为一组,彼此之间的关系为 OR。

可写入
floodlightCriteria.dimensions[] list 报表应包含的维度列表。 可写入
floodlightCriteria.floodlightConfigId nested object 要在此报表中显示数据的 Floodlight ID。系统将自动添加与此 ID 相关联的所有广告客户。值的维度必须是“dfa:floodlightConfigId”。 可写入
floodlightCriteria.metricNames[] list 报表应包含的指标名称列表。 可写入
format string 报表的输出格式,如果未指定,默认格式为 CSV。请注意,如果报表的大小超出格式的容量,已完成的报表文件中的实际格式可能会所有不同。如此一来,CSV 就会成为后备格式。

可接受的值包括:
  • CSV
  • EXCEL
可写入
pathAttributionCriteria.activityFilters[] list 要过滤的“dfa:activity”值列表。 可写入
pathAttributionCriteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
pathAttributionCriteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
pathAttributionCriteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
pathAttributionCriteria.dimensions[] list 报表应包含的维度列表。 可写入
pathAttributionCriteria.floodlightConfigId nested object 要在此报表中显示数据的 Floodlight ID。系统将自动添加与此 ID 相关联的所有广告客户。值的维度必须是“dfa:floodlightConfigId”。 可写入
pathAttributionCriteria.metricNames[] list 报表应包含的指标名称列表。 可写入
pathCriteria.activityFilters[] list 要过滤的“dfa:activity”值列表。 可写入
pathCriteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
pathCriteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
pathCriteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
pathCriteria.dimensions[] list 报表应包含的维度列表。 可写入
pathCriteria.floodlightConfigId nested object 要在此报表中显示数据的 Floodlight ID。系统将自动添加与此 ID 相关联的所有广告客户。值的维度必须是“dfa:floodlightConfigId”。 可写入
pathCriteria.metricNames[] list 报表应包含的指标名称列表。 可写入
pathToConversionCriteria.activityFilters[] list 要过滤的“dfa:activity”值列表。 可写入
pathToConversionCriteria.conversionDimensions[] list 报表应包含的转化维度列表。 可写入
pathToConversionCriteria.customFloodlightVariables[] list 报表应包含的自定义 Floodlight 变量列表。 可写入
pathToConversionCriteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
pathToConversionCriteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
pathToConversionCriteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
pathToConversionCriteria.floodlightConfigId nested object 要在此报表中显示数据的 Floodlight ID。系统将自动添加与此 ID 相关联的所有广告客户。值的维度必须是“dfa:floodlightConfigId”。 可写入
pathToConversionCriteria.metricNames[] list 报表应包含的指标名称列表。 可写入
pathToConversionCriteria.perInteractionDimensions[] list 报表应包含的每次互动维度列表。 可写入
reachCriteria.activities.filters[] list 活动过滤器列表。所有维度值都必须是“dfa:activity”类型或者是“dfa:activityGroup”类型。 可写入
reachCriteria.customRichMediaEvents.filteredEventIds[] list 自定义 Rich Media 事件 ID 列表。所有维度值都必须是“dfa:richMediaEventTypeIdAndName”类型。 可写入
reachCriteria.dateRange.endDate date 日期范围的结束日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
reachCriteria.dateRange.relativeDateRange string 相对于报表生成日期的日期范围。

可接受的值包括:
  • LAST_14_DAYS
  • LAST_24_MONTHS
  • LAST_30_DAYS
  • LAST_365_DAYS
  • LAST_60_DAYS
  • LAST_7_DAYS
  • LAST_90_DAYS
  • MONTH_TO_DATE
  • PREVIOUS_MONTH
  • PREVIOUS_QUARTER
  • PREVIOUS_WEEK
  • PREVIOUS_YEAR
  • QUARTER_TO_DATE
  • TODAY
  • WEEK_TO_DATE
  • YEAR_TO_DATE
  • YESTERDAY
可写入
reachCriteria.dateRange.startDate date 日期范围的开始日期(含)。字符串格式为“yyyy-MM-dd”。 可写入
reachCriteria.dimensionFilters[] list 用来对维度进行过滤的过滤器列表。

不同维度的过滤器之间为 AND 关系;同一个维度的多个过滤器归为一组,彼此之间的关系为 OR。

可写入
reachCriteria.dimensions[] list 报表应包含的维度列表。 可写入
reachCriteria.enableAllDimensionCombinations boolean 是否在报表中启用所有覆盖面维度组合。默认值为 false。如果启用,报表的日期范围应为过去 42 天内。 可写入
reachCriteria.metricNames[] list 报表应包含的指标名称列表。 可写入
reachCriteria.reachByFrequencyMetricNames[] list 报表应包含的按频次计算的覆盖面指标名称列表。 可写入
schedule object 报表的时间安排。只有在报表的“dateRange”是相对日期范围,并且该相对日期范围不是“TODAY”时,才可以设置。 可写入
schedule.every integer 指定应每隔几天、几周或几个月生成一次报表。如果“repeats”值为“DAILY”、“WEEKLY”或“MONTHLY”,就需要进行设置。 可写入
schedule.repeatsOnWeekDays[] list 列出值为“WEEKLY”时定期生成的报表应在一周的哪几天生成。 可写入
schedule.runsOnDayOfMonth string 枚举值,用来指定“每月”定期生成的报表应将每月的同一天作为“startDate”进行重复,还是在每月的相应周的同一天重复。

例如:如果“startDate”是 2012 年 4 月 2 日 (2012-04-02) 星期一,那么“DAY_OF_MONTH”就会在每月的第 2 天生成后续报表,而“WEEK_OF_MONTH”会在每月的第一个星期一生成后续报表。



可接受的值包括:
  • DAY_OF_MONTH
  • WEEK_OF_MONTH
可写入

响应

如果成功,此方法将在响应正文中返回一项 Report 资源

试试看!

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