FreshnessInfo
Stay organized with collections
Save and categorize content based on your preferences.
Represents the latest available time that can be requested in a [TimelineSpec][google.play.developer.reporting.${apiVersion}.TimelineSpec].
Different 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.
| JSON representation |
{
"freshnesses": [
{
object (Freshness)
}
]
} |
| Fields |
freshnesses[] |
object (Freshness)
Information about data freshness for every supported aggregation period. This field has set semantics, keyed by the aggregationPeriod field.
|
Freshness
Information about data freshness for a single aggregation period.
| Fields |
aggregationPeriod |
enum (AggregationPeriod)
Aggregation period for which data is available.
|
latestEndTime |
object (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].
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-19 UTC.
[null,null,["Last updated 2025-03-19 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\\]. |"]]