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]. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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\\]. |"]]