FreshnessInfo
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
代表可在 [TimelineSpec][google.play.developer.reporting.${apiVersion}.TimelineSpec] 中要求的最新可用時間。
不同的匯總期間有不同的資料更新間隔。舉例來說,如果系統只會在一天結束時計算這類匯總資料,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] 中重複使用。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eFreshness refers to the latest available time that can be requested in a TimelineSpec.\u003c/p\u003e\n"],["\u003cp\u003eDifferent aggregation periods (e.g., DAILY, HOURLY) have varying freshness levels, with \u003ccode\u003eDAILY\u003c/code\u003e potentially lagging behind \u003ccode\u003eHOURLY\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFreshness information is provided for each supported aggregation period, including the latest available end time for data in that period.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elatestEndTime\u003c/code\u003e field in FreshnessInfo is designed for easy integration into TimelineSpec's \u003ccode\u003eend_time\u003c/code\u003e for querying data.\u003c/p\u003e\n"]]],["The content describes data freshness for different aggregation periods, represented in JSON. Data freshness is captured in \"freshnesses,\" which contains information for each supported period. Each \"Freshness\" includes an `aggregationPeriod` and the `latestEndTime`. The `latestEndTime` indicates the most recent available data point's end time for that period, specified in the metric set's default timezone. The end time format allows direct use in `TimelineSpec.end_time`. Different periods like DAILY or HOURLY can have different data freshness.\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/v1alpha1/FreshnessInfo#Freshness) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `freshnesses[]` | `object (`[Freshness](/play/developer/reporting/reference/rest/v1alpha1/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/v1alpha1/AggregationPeriod), \"latestEndTime\": { object (/play/developer/reporting/reference/rest/Shared.Types/DateTime) } } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `aggregationPeriod` | `enum (`[AggregationPeriod](/play/developer/reporting/reference/rest/v1alpha1/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\\]. |"]]