Method: accounts.locations.reportInsights

위치별 하나 이상의 측정항목에 대한 통계가 포함된 보고서를 반환합니다.

HTTP 요청

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

계정 리소스 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
필드
locationNames[]

string

통계를 가져올 위치 모음으로, 이름으로 지정됩니다.
basicRequest

object (BasicMetricsRequest)

보고서에 기본 측정항목 통계를 포함하도록 요청합니다.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

보고서에 운전 경로 요청에 관한 통계를 포함하기 위한 요청입니다.

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

Insights.ReportLocationInsights에 대한 응답 메시지입니다.

JSON 표현 
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
필드
locationMetrics[]

object (LocationMetrics)

위치별 측정항목 값 모음입니다.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

운전 방향 관련 측정항목의 값 모음입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

자세한 내용은 OAuth 2.0 개요를 참고하세요.

DrivingDirectionMetricsRequest

운전 경로 통계 요청

JSON 표현 
{
  "numDays": enum (NumDays),
  "languageCode": string
}
필드
numDays

enum (NumDays)

데이터를 집계할 기간(일)입니다. 반환된 결과는 요청된 지난 일수 동안의 데이터를 사용할 수 있습니다. 유효한 값은 7, 30, 90입니다.
languageCode

string

언어의 BCP 47 코드입니다. 언어 코드가 제공되지 않으면 기본적으로 영어가 사용됩니다.

NumDays

이 요청이 지원할 수 있는 일수입니다.

열거형
SEVEN 7일. 기본값입니다.
THIRTY 30일
NINETY 90일입니다.

LocationMetrics

특정 기간 동안 위치와 연결된 일련의 측정항목 및 BreakdownMetrics입니다.

JSON 표현 
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
필드
locationName

string

이러한 값이 속한 위치 리소스 이름입니다.
timeZone

string

위치의 IANA 시간대입니다.
metricValues[]

object (MetricValue)

요청된 측정항목의 값 목록입니다.

LocationDrivingDirectionMetrics

사람들이 주로 출신하는 지역으로 색인이 생성된 위치입니다. 이는 각 지역에서 이 위치에 대한 운전 경로 요청 수를 집계하여 파악합니다.

JSON 표현 
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
필드
locationName

string

이 측정항목 값이 속한 위치 리소스 이름입니다.
topDirectionSources[]

object (TopDirectionSources)

출처 지역별 운전경로 요청 일반적으로 결과는 개수순으로 정렬되며 최대 10개까지 표시됩니다.
timeZone

string

위치의 시간대 (IANA 시간대 ID, 예: '유럽/런던')

TopDirectionSources

운전 경로 요청이 가장 많이 발생한 지역입니다.

JSON 표현 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
필드
dayCount

integer

데이터가 집계되는 일수입니다.
regionCounts[]

object (RegionCount)

개수 기준으로 내림차순으로 정렬된 지역

RegionCount

연결된 요청 수가 있는 지역입니다.

JSON 표현 
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
필드
latlng

object (LatLng)

지역의 중심입니다.
label

string

사람이 읽을 수 있는 지역 라벨입니다.
count

string (int64 format)

이 지역에서 발생한 운전 경로 요청 수입니다.