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 per includere nel report informazioni sulle metriche di base.

drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Una richiesta per includere nel report informazioni sulle richieste di indicazioni stradali.

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

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 dati disponibili relativi all'ultimo numero di 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 per 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 località 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 da cui provengono solitamente le persone. Questo valore viene acquisito conteggiando il numero di richieste di indicazioni stradali verso questa località provenienti da ogni regione.

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

string

Il nome della risorsa località a cui appartiene questo valore della metrica.

topDirectionSources[]

object (TopDirectionSources)

Richieste di indicazioni stradali per regione di origine. Per convenzione, queste informazioni sono ordinate in base al conteggio, con al massimo 10 risultati.

timeZone

string

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

TopDirectionSources

Regioni principali da cui provengono le richieste di indicazioni stradali.

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

integer

I dati relativi al numero di giorni vengono aggregati.

regionCounts[]

object (RegionCount)

Regioni ordinate in ordine decrescente per conteggio.

RegionCount

Una regione con il numero di richieste associato.

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.