Crea una scheda GMB per una sede

Parametri

Corpo

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

Risposte

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 scheda Google Business Profile completamente nuova per una sede di Listings API e la associa a un account Google connesso. Usa questo endpoint quando la sede non ha ancora alcuna scheda Google, a differenza di connect-listing, che collega una sede di Listings API a una scheda già esistente nell'account Google.

Struttura della richiesta. Il corpo deve essere racchiuso in un oggetto input con due campi obbligatori: locationId (il Relay ID della sede codificato in base64) e connectedAccountId (l'account Google in cui creare la scheda). folderId è facoltativo; passalo per inserire la nuova scheda in un gruppo specifico dell'account Google, riportandolo senza modifiche da Elenca le cartelle. L'invio di un corpo piatto, non racchiuso nell'oggetto, viene rifiutato con uno stato HTTP 400.

La creazione è asincrona: success: true significa che la richiesta è stata accettata, non che la scheda sia immediatamente online. Google esamina i nuovi profili prima che vengano pubblicati.

Caso d'uso: creazione della presenza su Google per un punto vendita appena aperto. Un cliente apre una nuova sede che non ha ancora un profilo Google Business Profile. Crea la sede in Listings API, connetti l'account Google del cliente, quindi chiama questo endpoint con l'ID della sede e connectedAccountId affinché Listings API invii la nuova scheda a Google nell'ambito di quell'account. In seguito, interroga periodicamente le schede della sede per monitorare il passaggio della nuova scheda da in attesa a verificata.

La sede deve già contenere informazioni aziendali valide (nome, indirizzo, telefono) prima che sia possibile creare una scheda, e può esistere una sola scheda Google per sede. In caso di errore, errors ne spiega il motivo: in genere, nella sede mancano campi obbligatori, la sede ha già una scheda Google, è archiviata oppure l'account connesso non è attivo. Riconnetti un account la cui connessione non è più valida tramite l'endpoint connect-google. Tieni presente che l'endpoint attualmente restituisce success: true anche quando connectedAccountId non è un account Google reale e connesso, quindi verifica che la scheda compaia effettivamente (tramite le schede della sede) anziché affidarti soltanto a 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" } }'

Parametri

Corpo

Richiesta di esempio

Risposte