Einen GMB-Eintrag für einen Standort erstellen

Parameter

Body

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

Antworten

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.

Erstellt einen vollständig neuen Google Business Profile-Eintrag für einen Standort in der Listings API und ordnet ihn einem verbundenen Google-Konto zu. Verwenden Sie diesen Endpunkt, wenn der Standort noch überhaupt keinen Google-Eintrag hat, im Gegensatz zu connect-listing, das einen Standort in der Listings API mit einem Eintrag verknüpft, der bereits im Google-Konto vorhanden ist.

Aufbau der Anfrage. Der Body muss in ein input-Objekt mit zwei Pflichtfeldern eingebettet sein: locationId (die base64-codierte Relay-ID des Standorts) und connectedAccountId (das Google-Konto, unter dem der Eintrag erstellt werden soll). folderId ist optional; übergeben Sie diesen Wert, um den neuen Eintrag in einer bestimmten Google-Kontogruppe anzulegen, und übernehmen Sie ihn unverändert aus Ordner auflisten. Ein flacher Body ohne umschließendes Objekt wird mit HTTP 400 abgelehnt.

Die Erstellung erfolgt asynchron: success: true bedeutet, dass die Anfrage angenommen wurde, nicht, dass der Eintrag sofort live ist. Google prüft neue Profile, bevor sie veröffentlicht werden.

Anwendungsfall: Google-Präsenz für ein völlig neues Ladengeschäft einrichten. Ein Kunde eröffnet einen neuen Standort, der noch kein Google Business Profile hat. Erstellen Sie den Standort in der Listings API, verbinden Sie das Google-Konto des Kunden und rufen Sie dann diesen Endpunkt mit der ID des Standorts und connectedAccountId auf, damit die Listings API den neuen Eintrag unter diesem Konto bei Google einreicht. Fragen Sie anschließend regelmäßig die Einträge des Standorts ab, um den Übergang von pending zu verified zu verfolgen.

Der Standort muss bereits gültige Unternehmensinformationen (Name, Adresse, Telefonnummer) enthalten, bevor ein Eintrag erstellt werden kann, und pro Standort kann nur ein Google-Eintrag vorhanden sein. Bei einem Fehler erläutert errors den Grund; in der Regel fehlen dem Standort Pflichtfelder, er hat bereits einen Google-Eintrag, ist archiviert oder das verbundene Konto ist nicht aktiv. Verbinden Sie ein Konto, dessen Verbindung nicht mehr aktuell ist, über den Endpunkt connect-google erneut. Beachten Sie, dass der Endpunkt derzeit auch dann success: true zurückgibt, wenn connectedAccountId kein echtes, verbundenes Google-Konto ist; prüfen Sie daher anhand der Einträge des Standorts, ob der Eintrag tatsächlich erscheint, statt sich allein auf success zu verlassen.

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" } }'

Parameter

Body

Beispielanfrage

Antworten