L'API
Google Business Performance propose une
NOUVELLE méthode qui permet d'extraire plusieurs `DailyMetrics` avec une seule requête API.
Consultez le
planning d'abandon et les instructions pour migrer de la méthode API reportInsights v4 à l'API Google Business Profile Performance.
Method: accounts.listRecommendGoogleLocations
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.managehttps://www.googleapis.com/auth/business.manage
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eLists recommended Google Locations for a specified Business Profile account, suitable for personal accounts and location groups.\u003c/p\u003e\n"],["\u003cp\u003eRecommendations are based on locations the user has access to and are sorted by relevance.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes location details, total recommendations, and pagination token for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Business Profile management.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listRecommendGoogleLocations\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListRecommendedGoogleLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nList all the [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)s that have been recommended to the specified Business Profile account. Recommendations are provided for personal accounts and location groups only, requests for all other account types will result in an error. The recommendations for location groups are based on the locations in that group.\n\nThe recommendations for personal accounts are based on all of the locations that the user has access to on Business Profile (which includes locations they can access through location groups), and is a superset of all recommendations generated for the user.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------|\n| `name` | `string` Name of the account resource to fetch recommended Google locations for. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many locations to fetch per page. Default is 25, minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, the next page of locations is retrieved. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for GoogleLocations.ListRecommendedGoogleLocations.\n\nIt also contains some locations that have been claimed by other Business Profile users since the last time they were recommended to this Business Profile account.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"googleLocations\": [ { object (/my-business/reference/rest/v4/googleLocations#GoogleLocation) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `googleLocations[]` | `object (`[GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation)`)` The locations recommended to a Business Profile account. Each of these represents a [GoogleLocation](/my-business/reference/rest/v4/googleLocations#GoogleLocation) that is present on Maps. The locations are sorted in decreasing order of relevance to the Business Profile account. |\n| `totalSize` | `integer` The total number of recommended locations for this Business Profile account, irrespective of pagination. |\n| `nextPageToken` | `string` During pagination, if there are more locations available to be fetched in the next page, this field is populated with a token to fetch the next page of locations in a subsequent call. If there are no more locations to be fetched, this field is not present in the response. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
