Créer une fiche GMB pour un établissement

Paramètres

Corps

Nom	Type	Obligatoire	Description
input	object	obligatoire	Wrapper object. The entire request body must be nested under `input`.
input.locationId	string	obligatoire	Base64-encoded location Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) of the location to create the Google listing for.
input.connectedAccountId	string	obligatoire	UUID of the connected Google account the new listing should be created under. Taken from `GET /connected-accounts`.
input.folderId	string	facultatif	Google account group to create the listing inside, as the `accounts/{id}` string from the folders endpoint. Omit to create it at the account root.

Réponses

200Request accepted. `success: true` means GMB listing creation was initiated.

Response

{  "data": {    "createGmbListingForLocation": {      "clientMutationId": null,      "success": true,      "errors": null    }  }}

400Bad request, the body was not wrapped in `input` (error message: `Variable "$input" of required type "CreateGmbListingForLocationInput!" was not provided`).

401Unauthenticated, missing or invalid API key.

Crée une toute nouvelle fiche Google Business Profile pour un établissement Listings API et l’associe à un compte Google connecté. Utilisez cette opération lorsque l’établissement ne possède encore aucune fiche Google, contrairement à connect-listing, qui associe un établissement Listings API à une fiche déjà présente dans le compte Google.

Structure de la requête. Le corps doit être encapsulé dans un objet input comportant deux champs obligatoires : locationId (l’identifiant Relay de l’établissement encodé en base64) et connectedAccountId (le compte Google sous lequel créer la fiche). folderId est facultatif ; transmettez-le pour placer la nouvelle fiche dans un groupe spécifique du compte Google, en reprenant sa valeur telle quelle depuis Lister les dossiers. L’envoi d’un corps à plat, sans encapsulation, est rejeté avec un statut HTTP 400.

La création est asynchrone : success: true signifie que la requête a été acceptée, pas que la fiche est immédiatement en ligne. Google examine les nouveaux profils avant leur publication.

Cas d’utilisation : créer une présence sur Google pour un tout nouveau point de vente. Un client ouvre un nouvel établissement qui ne possède pas encore de fiche Google Business Profile. Créez l’établissement Listings API, connectez le compte Google du client, puis appelez cet endpoint avec l’identifiant de l’établissement et connectedAccountId pour que Listings API soumette la nouvelle fiche à Google sous ce compte. Interrogez ensuite régulièrement les fiches de l’établissement pour suivre le passage de la nouvelle fiche du statut pending au statut verified.

L’établissement doit déjà comporter des informations professionnelles valides (nom, adresse, téléphone) avant qu’une fiche puisse être créée, et une seule fiche Google peut exister par établissement. En cas d’échec, errors en explique la raison : généralement, des champs obligatoires manquent pour l’établissement, celui-ci possède déjà une fiche Google, il est archivé ou le compte connecté n’est pas actif. Reconnectez un compte dont la connexion n’est plus valide à l’aide de l’endpoint connect-google. Notez que l’endpoint renvoie actuellement success: true même lorsque connectedAccountId ne correspond pas à un véritable compte Google connecté ; vérifiez donc que la fiche apparaît effectivement (via les fiches de l’établissement) au lieu de vous fier uniquement à success.

curl -X POST 'https://listingsapi.com/api/v4/locations/create/gmb-listing' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5" } }'

Paramètres

Corps

Exemple de requête

Réponses