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)

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