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인 경우 [TimelineSpec.end_time][google.play.developer.reporting.TimelineSpec.end_time]에서 쉽게 재사용할 수 있도록 이 필드의 값은 2021-06-24
00:00:00 America/Los_Angeles이 됩니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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\\]. |"]]
