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 petunjuk arah 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 untuk data agregasi. Hasil yang ditampilkan akan menjadi data yang tersedia selama jumlah hari terakhir yang diminta. Nilai yang valid adalah 7, 30, dan 90.

languageCode

string

Kode BCP 47 untuk bahasa. Jika kode bahasa tidak diberikan, kode default 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 yang mencakup 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 petunjuk arah ke lokasi ini dari setiap wilayah.

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

string

Nama resource lokasi yang mencakup nilai metrik ini.

topDirectionSources[]

object (TopDirectionSources)

Permintaan petunjuk arah menurut wilayah sumber. Berdasarkan konvensi, urutan ini diurutkan berdasarkan jumlah dengan maksimal 10 hasil.

timeZone

string

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

TopDirectionSources

Wilayah teratas tempat asal permintaan rute mobil.

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

integer

Jumlah hari data dikumpulkan.

regionCounts[]

object (RegionCount)

Wilayah yang diurutkan dalam urutan menurun berdasarkan 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 petunjuk arah dari wilayah ini.