Obtenir des établissements par leurs IDs

Nom	Type	Obligatoire	Description	Par défaut
ids	string	obligatoire	JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value.	—

Nom

Type

Obligatoire

Description

Par défaut

ids

string

obligatoire

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

—

Réponses

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.

Récupère les informations complètes sur les établissements correspondant à un ensemble précis d’IDs en une seule requête, ce qui est bien moins coûteux qu’un appel GET par établissement. Les établissements actifs comme archivés peuvent être récupérés. Transmettez les IDs sous forme de tableau encodé en JSON dans le paramètre de requête ids et appliquez-lui un encodage URL.

Cas d’utilisation : enrichir un lot d’IDs provenant d’un webhook ou d’une tâche. Lorsque vous recevez une liste d’IDs d’établissement (depuis votre propre stockage, la charge utile d’un webhook ou un parcours paginé de la liste des établissements), récupérez tous les établissements correspondants en une seule fois : ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. Les IDs qui n’existent pas dans votre compte sont ignorés dans le tableau sans provoquer d’erreur ; comparez donc le nombre de résultats renvoyés au nombre d’IDs demandés pour détecter les IDs obsolètes.

Point d’attention : la clé du paramètre de requête est ids. Cet endpoint lit le tableau JSON dans le paramètre ids. Regrouper de nombreux IDs dans un seul appel vous permet de rester largement en dessous de la limite de débit, contrairement à une boucle de recherches individuelles ; si vous effectuez ces recherches en parallèle, respectez l’en-tête Retry-After en cas de réponse 429.

Pour chaque établissement, la réponse contient placeActionLinks (les liens d’action Google gérés par Listings API) et discoveredPlaceActionLinks (les liens trouvés directement sur la fiche Google de l’établissement qui ne sont pas encore gérés). Consultez le guide des liens d’action pour les établissements.

Obtenir des établissements par leurs IDs

Paramètres

Chaîne de requête

Réponses