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)

이 지역의 운전 경로 요청 수입니다.