Method: accounts.locations.reportInsights

Affiche un rapport contenant des insights sur une ou plusieurs métriques par établissement.

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)

Demande d'inclusion d'insights de base sur les métriques dans le rapport.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Demande d'inclusion d'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 emplacement.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Ensemble de valeurs permettant de générer des 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 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 du langage. 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 RépartitionMetrics associées à un établissement sur une période donnée.

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

string

Nom de ressource d'emplacement auquel ces valeurs appartiennent.
timeZone

string

Fuseau horaire IANA de l'emplacement.
metricValues[]

object (MetricValue)

Liste de 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 ressource d'emplacement auquel 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") du lieu.

TopDirectionSources

Principales régions d'où proviennent les demandes 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 ordre décroissant du nombre.

RegionCount

Une région avec le 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 demandes d'itinéraires depuis cette région.