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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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\\]. |"]]
