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.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API GoogleLocations vous permet de vérifier à l'avance si un établissement a déjà été revendiqué dans une fiche d'établissement. Si c'est le cas, vous pouvez ainsi immédiatement demander d'y accéder. De plus, si vous gérez des comptes validés de manière groupée, vous pouvez sélectionner plus précisément les correspondances potentielles à l'avance et éviter la création d'établissements en double.
Le point de terminaison de l'API renvoie une URL indiquant si un établissement a déjà été revendiqué. S'il a été revendiqué, la même URL vous permet de lancer le processus de demande d'accès.
L'image suivante présente le processus permettant de devenir propriétaire d'un établissement.
Figure 1. Diagramme "Swimlane" illustrant la propriété des établissements des fiches
Complétez les étapes suivantes pour utiliser l'API GoogleLocations :
Demandez au marchand de vous fournir les données de localisation.
Appelez le point de terminaison googleLocations.search. Fournissez les données de localisation dans le corps de l'appel. Vous pouvez également les fournir dans une chaîne de requête, semblable à ce qu'un utilisateur saisit dans la recherche ou dans Maps. Par exemple, "Starbucks 76 av Champs-Élysées, 75008 Paris" est une chaîne de requête.
L'API affiche une liste des établissements potentiellement correspondants ainsi que des informations sur chaque établissement, comme locationName et l'adresse.
Sélectionnez l'établissement correspondant au vôtre. En l'absence de correspondance, appelez accounts.locations.create et passez à l'étape 5.
En fonction de l'état de requestAdminRightsUrl dans la réponse, effectuez les actions suivantes :
Si requestAdminRightsUrl existe, un autre utilisateur est propriétaire de la fiche.
Redirigez le marchand vers l'URL, afin qu'il lance une demande d'accès et de propriété pour l'établissement existant dans la fiche correspondante.
Si requestAdminRightsUrl n'existe pas, appelez accounts.locations.create et créez une fiche qui sera validée ultérieurement.
Si au cours de ces étapes, vous avez créé des fiches, vous pouvez utiliser les API de validation pour commencer à les valider. Pour en savoir plus, consultez Gérer la validation.
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\u003eThe GoogleLocations API helps determine if a Business Profile location has been claimed, allowing for access requests or creation of new listings.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to search for existing locations, initiate access requests if claimed, or create new listings if unclaimed.\u003c/p\u003e\n"],["\u003cp\u003eIf a new listing is created, leverage verification APIs to complete the setup process.\u003c/p\u003e\n"],["\u003cp\u003eThis API is intended for managing locations with existing business relationships and should not be used for lead generation or competitive analysis.\u003c/p\u003e\n"]]],["The GoogleLocations API determines if a location is claimed in Business Profile. Using the `googleLocations.search` endpoint, provide location data to find matching locations. If a match exists, check `requestAdminRightsUrl`; if present, initiate an access request via the provided URL. If not, or if no match is found, create a new location with `accounts.locations.create`. New listings require verification through the verification APIs. This API is for merchants with business relationships, not lead generation.\n"],null,["# GoogleLocations\n\nThe GoogleLocations API allows you to see in advance whether a location has been\nclaimed in Business Profile. This way, if the location has been claimed, you can immediately\nrequest access to the location. Also, if you manage bulk-verified accounts, you can more accurately\nselect potential matches in advance and avoid the creation of duplicate locations.\n\nThe API endpoint returns a URL that indicates if a location has already been claimed. If it has\nbeen claimed, the same URL allows you to start the access request process.\n\nThe following image provides an overview of the process to gain ownership of a location.\n**Figure 1.** Swimlane diagram of Business Profile location ownership\n\nThe following steps allow you to use the `GoogleLocations` API:\n\n1. Collect location data from the merchant.\n2. Call the\n [`googleLocations.search`](/my-business/reference/businessinformation/rest/v1/googleLocations)\n endpoint. Provide the location data within the body of the call. Alternatively, you can provide\n it in a query string, similar to what a user would enter in Search or Maps. For example,\n \"Starbucks 5th ave NYC.\"\n\n The API returns a list of potentially matching locations and information about each location,\n such as `locationName` and address.\n3. Select the location that matches your location. If there are no matches, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create), and skip to step 5.\n4. Based on the state of `requestAdminRightsUrl` in the response, take the following\n actions:\n\n 1. If `requestAdminRightsUrl` exists, another user has ownership of the listing. Direct the merchant to the URL to start a request for access and ownership of the existing location in Business Profile.\n 2. If `requestAdminRightsUrl` doesn't exist, call [`accounts.locations.create`](/my-business/reference/businessinformation/rest/v1/accounts.locations/create) and create a new listing that will be verified later.\n5. If you created new listings as part of this process, you can utilize the verification APIs to begin verification of the listings. For more information, see [Manage verification](/my-business/content/manage-verification).\n\n| **Note:** The GoogleLocations API is intended to find the status of locations for which your company has a business relationship with the merchant. The use of the endpoints for the purposes of lead generation or competitive analysis is against [Google's policies](/my-business/content/policies#prohibited_practices) and will result in revocation of API access."]]
