Method: accounts.listRecommendGoogleLocations

Répertorie tous les GoogleLocation qui ont été recommandés pour le compte de fiche d'établissement spécifié. Les recommandations ne sont fournies que pour les comptes personnels et les groupes d'établissements. Les demandes pour tous les autres types de comptes renverront une erreur. Les recommandations concernant les groupes d'établissements sont basées sur les établissements qu'ils contiennent.

Les recommandations pour les comptes personnels sont basées sur tous les établissements auxquels l'utilisateur a accès dans la fiche d'établissement (y compris ceux auxquels il peut accéder via des groupes d'établissements). Elles constituent un sur-ensemble de toutes les recommandations générées pour l'utilisateur.

Requête HTTP

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Nom de la ressource de compte pour laquelle extraire les emplacements Google recommandés.

Paramètres de requête

Paramètres
pageSize

integer

Nombre d'établissements à extraire par page. La valeur par défaut est 25, la minimale est 1 et la maximale est 100.
pageToken

string

Si une valeur est spécifiée, la page d'établissements suivante est récupérée.

Corps de la requête

Le corps de la requête doit être vide.

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 GoogleLocations.ListRecommendedGoogleLocations.

Il contient également des établissements qui ont été revendiqués par d'autres utilisateurs de la fiche depuis leur dernière recommandation dans ce compte.

Représentation JSON 
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
Champs
googleLocations[]

object (GoogleLocation)

Établissements recommandés pour un compte de fiche d'établissement. Chacun de ces éléments représente un GoogleLocation présent sur Maps. Les établissements sont triés par ordre décroissant de pertinence par rapport au compte de la fiche d'établissement.
totalSize

integer

Nombre total d'établissements recommandés pour ce compte de fiche d'établissement, quelle que soit la pagination.
nextPageToken

string

Au cours de la pagination, si d'autres emplacements sont disponibles à extraire sur la page suivante, ce champ est renseigné avec un jeton permettant d'extraire la page d'établissements suivante dans un appel ultérieur. S'il n'y a plus d'établissements à récupérer, ce champ n'est pas présent dans la réponse.

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.