Method: accounts.listRecommendGoogleLocations

Répertoriez tous les GoogleLocation qui ont été recommandés pour le compte de fiches 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 génèrent une erreur. Les recommandations pour 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 sa fiche d'établissement (y compris ceux auxquels il peut accéder via des groupes d'établissements). Il s'agit d'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 du 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 elle 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 d'établissement depuis leur dernière recommandation dans ce compte de fiches d'établissement.

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

object (GoogleLocation)

Établissements recommandés pour un compte de fiches 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 fiches d'établissement.

totalSize

integer

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

nextPageToken

string

Pendant la pagination, si d'autres établissements peuvent être récupérés 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.