Obtener ubicaciones por IDs

Nombre	Tipo	Obligatorio	Descripción	Predeterminado
ids	string	obligatorio	JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value.	—

Nombre

Tipo

Obligatorio

Descripción

Predeterminado

ids

string

obligatorio

JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value.

—

Respuestas

200Array of full location objects, one per resolved ID. Unknown IDs are omitted.

Response

{  "data": {    "getLocationsByIds": [      {        "id": "TG9jYXRpb246MTgwMDI4OQ==",        "databaseId": 1800289,        "accountId": 12345,        "storeId": null,        "name": "Jenny Home",        "archived": false,        "archivedAt": null,        "street": "600 Congress Ave, Suite 200",        "city": "Austin",        "stateIso": "TX",        "postalCode": "78701",        "countryIso": "US",        "countryCode": "1",        "latitude": "30.2711286",        "longitude": "-97.7436995",        "phone": "5125550142",        "additionalPhones": [],        "bizUrl": null,        "hideAddress": false,        "categoryId": 15,        "subCategoryId": 1432,        "subCategoryName": "Restaurants",        "additionalCategoryIds": [],        "description": "This is a standalone duplex house. A comfortable, private residence located in the Bouldin Creek neighborhood of Austin, offering spacious duplex living with easy access to the surrounding South Congress area and downtown Austin.",        "contentPreferredLanguage": "ENGLISH",        "businessHours": [],        "moreHours": [],        "package": "PREMIUM",        "planId": 3797,        "planName": "Launch",        "temporarilyClosed": false,        "ownerName": null,        "ownerEmail": null,        "paymentMethods": [],        "locationPhotos": [],        "isRestaurant": true,        "voiceStatus": 3,        "yearOfIncorporation": null,        "placeActionLinks": [          {            "placeActionType": "FOOD_ORDERING",            "uri": "https://order.example.com",            "isPreferred": true,            "name": "locations/1944.../placeActionLinks/54ada85bc246058a",            "submissionStatus": "success",            "submissionMessage": "Already up to date on Google.",            "lastSubmittedAt": "2026-07-08T12:14:36Z"          }        ],        "discoveredPlaceActionLinks": [          {            "placeActionType": "APPOINTMENT",            "uri": "https://book.example.com",            "isPreferred": false,            "name": "locations/1944.../placeActionLinks/abc123",            "providerType": "MERCHANT",            "isEditable": true          }        ]      }    ]  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Obtiene los detalles completos de las ubicaciones correspondientes a un conjunto específico de IDs en una sola solicitud, con un coste mucho menor que realizar un GET por ubicación. Se recuperan tanto las ubicaciones activas como las archivadas. Pasa los IDs como un array codificado en JSON en el parámetro de consulta ids y aplica la codificación URL al array.

Caso de uso: obtener los datos de un lote de IDs procedente de un webhook o una tarea. Cuando recibas una lista de IDs de ubicación (de tu propio almacén de datos, del contenido de un webhook o de un recorrido paginado de la lista de ubicaciones), obtén los datos de todas a la vez: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. Los IDs que no existen en tu cuenta se omiten del array sin avisar ni generar un error, así que compara la cantidad devuelta con la solicitada para detectar IDs obsoletos.

Ten en cuenta que la clave de consulta es ids. Este endpoint lee el array JSON del parámetro ids. Agrupar muchos IDs en una sola llamada te mantiene muy por debajo del límite de solicitudes en comparación con realizar consultas individuales en un bucle; si las realizas en paralelo, respeta la cabecera Retry-After cuando recibas un 429.

Para cada ubicación se devuelven placeActionLinks (los enlaces de acción de Google que gestiona Listings API) y discoveredPlaceActionLinks (los enlaces encontrados directamente en el perfil de Google del negocio que aún no se gestionan). Consulta la guía de enlaces de acción de lugar.

Parámetros

Consulta

Respuestas