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 menurut namanya.
basicRequest

object (BasicMetricsRequest)

Permintaan untuk menyertakan insight metrik dasar dalam laporan.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Permintaan untuk menyertakan insight tentang 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 menurut 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 gabungan. Hasil yang ditampilkan akan berupa data yang tersedia selama jumlah hari terakhir yang diminta. Nilai yang valid adalah 7, 30, dan 90.
languageCode

string

Kode BCP 47 untuk bahasa tersebut. Jika kode bahasa tidak diberikan, maka default-nya 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 rentang waktu tertentu.

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 memiliki nilai metrik ini.
topDirectionSources[]

object (TopDirectionSources)

Permintaan petunjuk arah berdasarkan wilayah sumber. Berdasarkan konvensi, kolom 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 permintaan rute mobil berasal.

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

integer

Jumlah hari data yang digabungkan.
regionCounts[]

object (RegionCount)

Wilayah yang diurutkan secara menurun berdasarkan jumlah.

RegionCount

Wilayah dengan jumlah permintaan terkaitnya.

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.