La API Performance de Perfil de Empresa en Google tiene un NUEVO método que permite obtener varios valores del parámetro "DailyMetrics" con una misma solicitud. Consulta el calendario de desactivación y las instrucciones para pasar del método reportInsights de la versión 4 de la API de Google My Business a la API Performance de Perfil de Empresa en Google.
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
La API GoogleLocations permite comprobar por adelantado si una ubicación ya se ha reclamado en Perfil de Empresa. De este modo, si la ubicación se ha reclamado, puedes solicitar inmediatamente acceso a ella. Además, si gestionas cuentas verificadas en bloque, puedes seleccionar con más precisión posibles coincidencias y evitar que se creen ubicaciones duplicadas.
El endpoint de la API devuelve una URL que indica si la ubicación en cuestión ya se ha reclamado. Si se ha reclamado, la misma URL te permite iniciar el proceso de solicitud de acceso.
En esta imagen se resume el proceso para obtener la propiedad de una ubicación.
Figura 1. Diagrama del proceso de asignación de la propiedad de una ubicación de Perfil de Empresa
Los siguientes pasos te permiten usar la API GoogleLocations:
Recoge los datos de la ubicación del comercio.
Haz una llamada al endpoint googleLocations.search. Proporciona los datos de la ubicación en el cuerpo de la llamada. También puedes proporcionarlos en una cadena de consulta similar a la que escriben los usuarios en la Búsqueda o en Maps. Por ejemplo: "Starbucks Gran Vía Madrid".
La API devuelve una lista con posibles ubicaciones coincidentes e información sobre cada una, como el valor de locationName y la dirección.
Selecciona la ubicación correspondiente a tu ubicación. Si no hay coincidencias, haz una llamada a accounts.locations.create y ve directamente al paso 5.
En función del estado de requestAdminRightsUrl que se muestre en la respuesta, sigue el paso que corresponda:
Si requestAdminRightsUrl existe, otro usuario es el propietario de la ficha.
Dirige al comercio a la URL para iniciar una solicitud de acceso y propiedad de la ubicación ya registrada en Perfil de Empresa.
Si requestAdminRightsUrl no existe, haz una llamada a accounts.locations.create y crea una ficha que se verificará más tarde.
Si has creado fichas de empresa como parte de este proceso, puedes utilizar las APIs de verificación para iniciar el proceso de verificación de esas fichas. Consulta más información en Gestionar la verificación.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Me falta la información que necesito","missingTheInformationINeed","thumb-down"],["Es demasiado complicado o hay demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Está obsoleto","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema de muestras o código","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-11-27 (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."]]
