Method: accounts.locations.reportInsights

Affiche un rapport contenant des insights sur une ou plusieurs métriques par zone géographique.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Nom de ressource du compte.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
Champs
locationNames[]

string

Ensemble d'établissements pour lesquels extraire des insights, spécifiés par leur nom.
basicRequest

object (BasicMetricsRequest)

Requête permettant d'inclure des insights de base sur les métriques dans le rapport.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Requête permettant d'inclure des insights sur les demandes d'itinéraire dans le rapport.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Message de réponse pour Insights.ReportLocationInsights.

Représentation JSON 
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
Champs
locationMetrics[]

object (LocationMetrics)

Ensemble de valeurs de métriques par zone géographique.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Ensemble de valeurs pour les métriques liées aux itinéraires.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

DrivingDirectionMetricsRequest

Requête d'insights d'itinéraire.

Représentation JSON 
{
  "numDays": enum (NumDays),
  "languageCode": string
}
Champs
numDays

enum (NumDays)

Nombre de jours pour lesquels les données doivent être agrégées. Les résultats affichés seront disponibles pour le dernier nombre de jours demandés. Les valeurs valides sont 7, 30 et 90.
languageCode

string

Code BCP 47 de la langue. Si aucun code de langue n'est fourni, la langue par défaut est l'anglais.

NumDays

Nombre de jours pendant lesquels cette demande peut prendre en charge cette demande.

Enums
SEVEN 7 jours. Il s'agit de la valeur par défaut.
THIRTY 30 jours.
NINETY 90 jours.

LocationMetrics

Série de métriques et de métriques de répartition associées à un emplacement sur une période donnée.

Représentation JSON 
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Champs
locationName

string

Nom de la ressource d'emplacement à laquelle ces valeurs appartiennent.
timeZone

string

le fuseau horaire IANA du lieu.
metricValues[]

object (MetricValue)

Liste des valeurs des métriques demandées.

LocationDrivingDirectionMetrics

Emplacement indexé avec les régions d'où proviennent habituellement les utilisateurs. Cette information est obtenue en comptabilisant le nombre de demandes d'itinéraire vers cet établissement provenant de chaque région.

Représentation JSON 
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
Champs
locationName

string

Nom de la ressource d'emplacement à laquelle cette valeur de métrique appartient.
topDirectionSources[]

object (TopDirectionSources)

Demandes d'itinéraire par région source. Par convention, les résultats sont triés par nombre avec un maximum de 10 résultats.
timeZone

string

Fuseau horaire (ID de fuseau horaire de l'IANA, par exemple "Europe/Londres") du lieu.

TopDirectionSources

Principales régions d'où proviennent les requêtes d'itinéraire.

Représentation JSON 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Champs
dayCount

integer

Nombre de jours sur lesquels les données sont agrégées.
regionCounts[]

object (RegionCount)

Régions triées par nombre décroissant.

RegionCount

Une région avec son nombre de requêtes associé.

Représentation JSON 
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Champs
latlng

object (LatLng)

Centre de la région.
label

string

Libellé lisible pour la région.
count

string (int64 format)

Nombre de requêtes d'itinéraire en voiture depuis cette région.