REST Resource: projects.locations.reportConfigs.reportDetails

资源：ReportDetail

用于描述 ReportDetail 对象的消息。ReportDetail 表示报告配置所生成的商品目录报告的元数据。

JSON 表示法 
{
  "name": string,
  "snapshotTime": string,
  "reportPathPrefix": string,
  "shardsCount": string,
  "status": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "targetDatetime": {
    object (DateTime)
  },
  "reportMetrics": {
    object (Metrics)
  }
}
字段
name

string

资源的名称。格式：projects/{projectNumber}/locations/{location}/reportConfigs/{report-config-id}/reportDetails/{report-detail-id}。
snapshotTime

string (Timestamp format)

快照时间。此时引用的是所有资产清单报告数据。

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
reportPathPrefix

string

每个报告分片的对象名称的前缀。此前缀包含除 extension 和 shard_id 以外的完整前缀。例如，如果 destinationPath 为 {report-config-id}/dt={datetime}，则分片对象名称为 gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_5.csv，reportPathPrefix 字段的值为 gs://my-insights/1A34-F2E456-12B456-1C3D/dt=2022-05-20T06:35/1A34-F2E456-12B456-1C3D_2022-05-20T06:35_。
shardsCount

string (int64 format)

为资产清单报告生成的分片总数。
status

object (Status)

资产清单报告的状态。
labels

map (key: string, value: string)

标签作为键值对

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
targetDatetime

object (DateTime)

生成资产清单报告的日期和时间。此字段会自动填充。targetDatetime 的时间部分始终为 0。
reportMetrics

object (Metrics)

广告资源报告的指标。

DateTime

表示民用时间（有时也表示实际时间）。

此类型可以通过以下几种可能的方式之一表示民用时间：

  • 当 utcOffset 已设置且 timeZone 未设置时：日历日的民用时间，相对于世界协调时间 (UTC) 有特定偏移量。
  • 如果已设置 timeZone 且未设置 utcOffset：特定时区中某个日历日的民用时间。
  • 如果未设置 timeZone 和 utcOffset：则为日历日的民用时间（以当地时间为准）。

日期相对于前公历。

如果年份、月份或日期为 0，则 DateTime 会被视为分别不具有特定的年份、月份或日期。

如果所有日期和时间字段均已设置，并且 time_offset oneof 的任一情况均已设置，则此类型还可用于表示实际时间。请考虑改用 Timestamp 消息来表示实际时间。如果您的用例还需要存储用户的时区，则可以在其他字段中执行此操作。

此类型的灵活性可能超出了某些应用的需求。请务必记录并验证应用的限制。

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
字段
year

integer

可选。某年。必须介于 1 到 9999 之间，如果指定不含年份的日期时间，则为 0。
month

integer

可选。某月。必须介于 1 到 12 之间，如果指定日期时间但未指定月份，则为 0。
day

integer

可选。某日。必须介于 1 到 31 之间并且对年份和月份有效，如果指定日期时间但不指定日期，则为 0。
hours

integer

可选。一天中的小时（采用 24 小时制）。应介于 0 到 23 之间，默认为 0（午夜）。对于业务结束时间等场景，API 可以选择允许“24:00:00”一值。
minutes

integer

可选。一天中某小时的分钟数。必须是 0 到 59 之间的数字，默认为 0。
seconds

integer

可选。时间的秒数部分。通常必须是 0 到 59 之间的数字，默认为 0。如果 API 允许闰秒，则 API 可以允许 60 一值。
nanos

integer

可选。秒数的小数部分（以纳秒为单位）。必须介于 0 到 999,999,999 之间，默认为 0。
联合字段 time_offset。可选。指定 DateTime 的 UTC 偏移量或时区。请谨慎选择这两者，因为时区数据未来可能会发生变化（例如，某个国家/地区修改了夏令时开始/结束日期，而受影响范围内的未来日期时间已存储）。如果省略，则 DateTime 会被视为当地时间。time_offset 只能是下列其中一项：
utcOffset

string (Duration format)

UTC 偏移量。必须是整秒数，介于 -18 小时到 +18 小时之间。例如，-4:00 的 UTC 偏移量将表示为 { seconds: -14400 }。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
timeZone

object (TimeZone)

时区。

TimeZone

表示 IANA 时区数据库中的时区。

JSON 表示法 
{
  "id": string,
  "version": string
}
字段
id

string

IANA 时区数据库中的时区。例如“America/New_York”。
version

string

可选。IANA 时区数据库版本号。例如“2019a”。

指标

与生成的报告关联的指标。

JSON 表示法 
{
  "processedRecordsCount": string
}
字段
processedRecordsCount

string (int64 format)

资产清单报告中包含的 Cloud Storage 对象的数量。

方法

get

 获取给定项目中给定位置的现有商品目录报告。

list

 列出给定项目中给定位置的广告资源报告。