FreshnessInfo
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
表示可在 [TimelineSpec][google.play.developer.reporting.${apiVersion}.TimelineSpec] 中请求的最新可用时间。
不同的汇总周期具有不同的新鲜度。例如,如果 DAILY
汇总每天只在结束时计算一次,那么 DAILY
汇总可能会落后于 HOURLY
。
JSON 表示法 |
{
"freshnesses": [
{
object (Freshness )
}
]
} |
字段 |
freshnesses[] |
object (Freshness )
有关每个受支持的汇总周期的数据新鲜度的信息。 此字段具有设置的语义,由 aggregationPeriod 字段键控。
|
时效性
字段 |
aggregationPeriod |
enum (AggregationPeriod )
提供数据的汇总周期。
|
latestEndTime |
object (DateTime )
相应汇总周期内可获取数据的最晚结束时间。时间以指标集的默认时区指定。 注意:TimelineSpec 中的时间范围以 [startTime,
endTime) 表示。例如,如果 DAILY 汇总周期的最新可用时间轴数据点是 2021-06-23 00:00:00
America/Los_Angeles ,则此字段的值将为 2021-06-24
00:00:00 America/Los_Angeles ,以便在 [TimelineSpec.end_time][google.play.developer.reporting.TimelineSpec.end_time] 中轻松重复使用。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eFreshness represents the latest available time that can be requested in a TimelineSpec.\u003c/p\u003e\n"],["\u003cp\u003eDifferent aggregation periods, such as DAILY and HOURLY, have varying freshness levels.\u003c/p\u003e\n"],["\u003cp\u003eFreshness information is provided for each supported aggregation period, including the latest available end time for data.\u003c/p\u003e\n"],["\u003cp\u003eThe latestEndTime field is designed for easy reuse in TimelineSpec.end_time, allowing users to specify time ranges for data retrieval.\u003c/p\u003e\n"]]],["Data freshness, representing the latest available time for a TimelineSpec request, varies by aggregation period (e.g., `DAILY` vs. `HOURLY`). Freshness information includes an array of `freshnesses`, each containing an `aggregationPeriod` and the corresponding `latestEndTime`. The `latestEndTime` indicates the most recent data available, formatted as a DateTime object in the metric set's default timezone, and is designed for direct use in `TimelineSpec.end_time` fields.\n"],null,["# FreshnessInfo\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [Freshness](#Freshness)\n - [JSON representation](#Freshness.SCHEMA_REPRESENTATION)\n\nRepresents the latest available time that can be requested in a \\[TimelineSpec\\]\\[google.play.developer.reporting.${apiVersion}.TimelineSpec\\].\n\nDifferent aggregation periods have different freshness. For example, `DAILY` aggregation may lag behind `HOURLY` in cases where such aggregation is computed only once at the end of the day.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"freshnesses\": [ { object (/play/developer/reporting/reference/rest/v1beta1/FreshnessInfo#Freshness) } ] } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `freshnesses[]` | `object (`[Freshness](/play/developer/reporting/reference/rest/v1beta1/FreshnessInfo#Freshness)`)` Information about data freshness for every supported aggregation period. This field has set semantics, keyed by the `aggregationPeriod` field. |\n\nFreshness\n---------\n\nInformation about data freshness for a single aggregation period.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"aggregationPeriod\": enum (/play/developer/reporting/reference/rest/v1beta1/AggregationPeriod), \"latestEndTime\": { object (/play/developer/reporting/reference/rest/Shared.Types/DateTime) } } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `aggregationPeriod` | `enum (`[AggregationPeriod](/play/developer/reporting/reference/rest/v1beta1/AggregationPeriod)`)` Aggregation period for which data is available. |\n| `latestEndTime` | `object (`[DateTime](/play/developer/reporting/reference/rest/Shared.Types/DateTime)`)` Latest end time for which data is available, for the aggregation period. The time is specified in the metric set's default timezone. *Note:* time ranges in TimelineSpec are represented as `[startTime, endTime)`. For example, if the latest available timeline data point for a `DAILY` aggregation period is `2021-06-23 00:00:00 America/Los_Angeles`, the value of this field would be `2021-06-24 00:00:00 America/Los_Angeles` so it can be easily reused in \\[TimelineSpec.end_time\\]\\[google.play.developer.reporting.TimelineSpec.end_time\\]. |"]]