Crear una ficha de GMB para una ubicación

Parámetros

Cuerpo

Nombre	Tipo	Obligatorio	Descripción
input	object	obligatorio	Wrapper object. The entire request body must be nested under `input`.
input.locationId	string	obligatorio	Base64-encoded location Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) of the location to create the Google listing for.
input.connectedAccountId	string	obligatorio	UUID of the connected Google account the new listing should be created under. Taken from `GET /connected-accounts`.
input.folderId	string	opcional	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.

Respuestas

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.

Crea una ficha de Google Business Profile completamente nueva para una ubicación de Listings API y la asocia a una cuenta de Google conectada. Usa esta opción cuando la ubicación aún no tenga ninguna ficha de Google, a diferencia de connect-listing, que vincula una ubicación de Listings API a una ficha que ya existe en la cuenta de Google.

Estructura de la solicitud. El cuerpo debe estar encapsulado en un objeto input con dos campos obligatorios: locationId (el ID Relay de la ubicación codificado en base64) y connectedAccountId (la cuenta de Google en la que se creará la ficha). folderId es opcional; pásalo para colocar la nueva ficha en un grupo específico de cuentas de Google, usando su valor sin cambios tal como se obtiene de Listar carpetas. Si envías un cuerpo plano, sin encapsular, la solicitud se rechaza con un estado HTTP 400.

La creación es asíncrona: success: true significa que la solicitud se ha aceptado, no que la ficha se publique al instante. Google revisa los perfiles nuevos antes de que se publiquen.

Caso de uso: crear una presencia en Google para un establecimiento completamente nuevo. Un cliente abre una nueva ubicación que aún no tiene un perfil de Google Business Profile. Crea la ubicación en Listings API, conecta la cuenta de Google del cliente y, a continuación, llama a este endpoint con el ID de la ubicación y el connectedAccountId para que Listings API envíe la nueva ficha a Google en esa cuenta. Después, consulta periódicamente las fichas de la ubicación para observar cómo la ficha pasa de pendiente a verificada.

La ubicación debe contener información válida del negocio (nombre, dirección y teléfono) antes de que se pueda crear una ficha, y solo puede existir una ficha de Google por ubicación. En caso de fallo, errors explica el motivo: normalmente, a la ubicación le faltan campos obligatorios, ya tiene una ficha de Google, está archivada o la cuenta conectada no está activa. Vuelve a conectar una cuenta cuya conexión haya caducado mediante el endpoint connect-google. Ten en cuenta que el endpoint actualmente devuelve success: true incluso cuando connectedAccountId no corresponde a una cuenta de Google real y conectada, así que confirma que la ficha aparece realmente (a través de las fichas de la ubicación) en lugar de basarte únicamente en 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" } }'

Parámetros

Cuerpo

Solicitud de ejemplo

Respuestas