FreshnessInfo
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מייצג את הזמן האחרון שזמין לבקשה ב-TimelineSpec [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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\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\\]. |"]]
