Method: accounts.locations.reportInsights

Menampilkan laporan yang berisi insight tentang satu atau beberapa metrik berdasarkan lokasi.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama resource akun.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
Kolom
locationNames[]

string

Kumpulan lokasi yang insight-nya akan diambil, yang ditentukan berdasarkan namanya.

basicRequest

object (BasicMetricsRequest)

Permintaan untuk menyertakan insight metrik dasar dalam laporan.

drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Permintaan untuk menyertakan insight tentang permintaan rute mobil dalam laporan.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk Insights.ReportLocationInsights.

Representasi JSON
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
Kolom
locationMetrics[]

object (LocationMetrics)

Kumpulan nilai metrik berdasarkan lokasi.

locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Kumpulan nilai untuk metrik terkait rute mobil.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

DrivingDirectionMetricsRequest

Permintaan insight rute mobil.

Representasi JSON
{
  "numDays": enum (NumDays),
  "languageCode": string
}
Kolom
numDays

enum (NumDays)

Jumlah hari pengumpulan data. Hasil yang ditampilkan akan menjadi data yang tersedia selama beberapa hari terakhir yang diminta. Nilai yang valid adalah 7, 30, dan 90.

languageCode

string

Kode BCP 47 untuk bahasa. Jika kode bahasa tidak disediakan, standarnya adalah bahasa Inggris.

NumDays

Jumlah hari yang dapat didukung permintaan ini.

Enum
SEVEN 7 hari. Nilai ini merupakan default.
THIRTY 30 hari.
NINETY 90 hari.

LocationMetrics

Serangkaian Metrik dan BreakdownMetrics yang terkait dengan Lokasi selama beberapa rentang waktu.

Representasi JSON
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Kolom
locationName

string

Nama resource lokasi dari nilai-nilai ini.

timeZone

string

Zona waktu IANA untuk lokasi.

metricValues[]

object (MetricValue)

Daftar nilai untuk metrik yang diminta.

LocationDrivingDirectionMetrics

Lokasi yang diindeks dengan wilayah tempat orang biasanya berasal. Metrik ini ditangkap dengan menghitung jumlah permintaan rute mobil ke lokasi ini dari masing-masing wilayah.

Representasi JSON
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
Kolom
locationName

string

Nama resource lokasi yang memiliki nilai metrik ini.

topDirectionSources[]

object (TopDirectionSources)

Permintaan rute mobil berdasarkan wilayah sumber. Berdasarkan konvensi, kolom ini diurutkan menurut jumlah dengan maksimal 10 hasil.

timeZone

string

Zona waktu (ID zona waktu IANA, misalnya, 'Eropa/London') untuk lokasi.

TopDirectionSources

Wilayah teratas tempat permintaan rute mobil berasal.

Representasi JSON
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Kolom
dayCount

integer

Jumlah hari pengumpulan data.

regionCounts[]

object (RegionCount)

Wilayah yang diurutkan secara menurun menurut jumlah.

RegionCount

Wilayah dengan jumlah permintaan terkait.

Representasi JSON
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Kolom
latlng

object (LatLng)

Pusat wilayah.

label

string

Label yang dapat dibaca manusia untuk wilayah tersebut.

count

string (int64 format)

Jumlah permintaan rute mobil dari wilayah ini.