Method: accounts.locations.reportInsights

Renvoie 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 la 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

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

object (BasicMetricsRequest)

Requête visant à inclure des insights de base sur les métriques dans le rapport.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Requête d'inclusion d'insights sur les requêtes de directions 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 emplacement.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Ensemble de valeurs pour les métriques liées aux directions de conduite.

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 sur les itinéraires.

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

enum (NumDays)

Nombre de jours pour lesquels agréger les données. Les résultats affichés seront les données 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 être traitée.

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 détaillées 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

Fuseau horaire IANA de l'emplacement.
metricValues[]

object (MetricValue)

Liste des valeurs pour les métriques demandées.

LocationDrivingDirectionMetrics

Emplacement indexé avec les régions d'où viennent généralement les utilisateurs. Ces données sont obtenues 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)

Requêtes d'itinéraire par région source. Par convention, les résultats sont triés par nombre (10 résultats au maximum).
timeZone

string

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

TopDirectionSources

Régions principales d'où proviennent les requêtes d'itinéraires

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 ordre décroissant du nombre de données.

RegionCount

Région avec le nombre de requêtes associées.

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éraires routiers provenant de cette région.