FreshnessInfo
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Biểu thị thời gian mới nhất có thể được yêu cầu trong [TimelineSpec][google.play.developer.reporting.${apiVersion}.TimelineSpec].
Các khoảng thời gian tổng hợp khác nhau sẽ có độ mới khác nhau. Ví dụ: việc tổng hợp DAILY
có thể chậm hơn HOURLY
trong trường hợp việc tổng hợp đó chỉ được tính một lần vào cuối ngày.
Biểu diễn dưới dạng JSON |
{
"freshnesses": [
{
object (Freshness )
}
]
} |
Trường |
freshnesses[] |
object (Freshness )
Thông tin về độ mới của dữ liệu cho mỗi khoảng thời gian tổng hợp được hỗ trợ. Trường này có ngữ nghĩa đã đặt, được khoá bằng trường aggregationPeriod .
|
Độ mới mẻ
Thông tin về độ mới của dữ liệu cho một khoảng thời gian tổng hợp duy nhất.
Trường |
aggregationPeriod |
enum (AggregationPeriod )
Khoảng thời gian tổng hợp mà dữ liệu có sẵn.
|
latestEndTime |
object (DateTime )
Thời gian kết thúc mới nhất mà dữ liệu có sẵn, cho khoảng thời gian tổng hợp. Thời gian được chỉ định theo múi giờ mặc định của bộ chỉ số. Lưu ý: các dải thời gian trong TimelineSpec được biểu thị dưới dạng [startTime,
endTime) . Ví dụ: nếu điểm dữ liệu mới nhất có sẵn trên dòng thời gian cho khoảng thời gian tổng hợp DAILY là 2021-06-23 00:00:00
America/Los_Angeles , thì giá trị của trường này sẽ là 2021-06-24
00:00:00 America/Los_Angeles để có thể dễ dàng sử dụng lại trong [TimelineSpec.end_time][google.play.developer.reporting.TimelineSpec.end_time].
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\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\\]. |"]]