Method: accounts.locations.reportInsights

Restituisce un report contenente approfondimenti su una o più metriche per località.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Il nome della risorsa dell'account.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

string

Una raccolta di località per cui recuperare gli insight, specificate dai nomi.

basicRequest

object (BasicMetricsRequest)

Una richiesta di inclusione di approfondimenti sulle metriche di base nel report.

drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Una richiesta di inclusione di approfondimenti sulle richieste di indicazioni stradali nel report.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Messaggio di risposta per Insights.ReportLocationInsights.

Rappresentazione JSON
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
Campi
locationMetrics[]

object (LocationMetrics)

Una raccolta di valori di metriche per località.

locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Una raccolta di valori per le metriche relative alle indicazioni stradali.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.

DrivingDirectionMetricsRequest

Una richiesta di informazioni sulle indicazioni stradali.

Rappresentazione JSON
{
  "numDays": enum (NumDays),
  "languageCode": string
}
Campi
numDays

enum (NumDays)

Il numero di giorni per i quali aggregare i dati. I risultati restituiti saranno i dati disponibili negli ultimi giorni richiesti. I valori validi sono 7, 30 e 90.

languageCode

string

Il codice BCP 47 per la lingua. Se non viene fornito un codice lingua, per impostazione predefinita viene utilizzato l'inglese.

NumDays

Numero di giorni supportati da questa richiesta.

Enum
SEVEN 7 giorni. Questo è il valore predefinito.
THIRTY 30 giorni.
NINETY 90 giorni.

LocationMetrics

Una serie di metriche e metriche di distribuzione associate a una località in un determinato intervallo di tempo.

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

string

Il nome della risorsa posizione a cui appartengono questi valori.

timeZone

string

Fuso orario IANA per la località.

metricValues[]

object (MetricValue)

Un elenco di valori per le metriche richieste.

LocationDrivingDirectionMetrics

Una località indicizzata con le regioni di provenienza abituali delle persone. Questo viene rilevato conteggiando quante richieste di indicazioni stradali per questa località provengono da ogni regione.

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

string

Il nome della risorsa posizione a cui appartiene questo valore della metrica.

topDirectionSources[]

object (TopDirectionSources)

Richieste di indicazioni stradali per regione di origine. Per convenzione, questi vengono ordinati in base al conteggio con un massimo di 10 risultati.

timeZone

string

Fuso orario (ID fuso orario IANA, ad esempio "Europe/London") della località.

TopDirectionSources

Le regioni principali da cui hanno avuto origine le richieste di indicazioni stradali.

Rappresentazione JSON
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Campi
dayCount

integer

Il numero di giorni per i quali i dati vengono aggregati.

regionCounts[]

object (RegionCount)

Regioni ordinate in ordine decrescente per numero.

RegionCount

Una regione con il relativo conteggio delle richieste.

Rappresentazione JSON
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Campi
latlng

object (LatLng)

Centro della regione.

label

string

Etichetta leggibile per la regione.

count

string (int64 format)

Numero di richieste di indicazioni stradali da questa regione.