GMB-Ordner für ein verbundenes Konto auflisten

Name	Typ	Erforderlich	Beschreibung
connectedAccountId	string	erforderlich	UUID of the connected Google account (from the list connected accounts endpoint).

Name

Typ

Erforderlich

Beschreibung

connectedAccountId

string

erforderlich

UUID of the connected Google account (from the list connected accounts endpoint).

Antworten

200Array of GMB folder objects.

Response

{  "data": {    "getFoldersUnderGoogleAccount": [      {        "folderId": "accounts/104890024806530350198",        "folderName": "Aniruddha Basu",        "locationCount": null      }    ]  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Gibt die Ordner (auch Gruppen oder Kontogruppen genannt) in Google Business Profile zurück, auf die das verbundene Google-Konto zugreifen kann. GBP organisiert Unternehmenseinträge innerhalb eines Kontos in Ordnern; jeder Ordner enthält folderId, folderName und, sofern von Google gemeldet, locationCount.

Anwendungsfall: einen neuen Eintrag im richtigen Ordner anlegen. Bevor Sie den Endpunkt create-GMB-listing aufrufen, listen Sie die Ordner des Kontos auf und lassen Sie den Kunden einen davon auswählen. Übergeben Sie den ausgewählten Wert für folderId (die unverändert verwendete Zeichenfolge accounts/{id}), damit der neue Eintrag in diesem Ordner statt auf der obersten Ebene des Kontos erstellt wird.

Anwendungsfall: mit der GBP-Struktur eines Kunden abgleichen. Marken mit mehreren Standorten verteilen ihre Einträge häufig auf mehrere Ordner. Rufen Sie die Ordnerliste ab, um die tatsächliche GBP-Hierarchie des Kunden in Ihrer Benutzeroberfläche darzustellen und sicherzustellen, dass Sie mit dem vom Kunden erwarteten Ordner synchronisieren. Beachten Sie, dass locationCount den Wert null haben kann, wenn Google keine Anzahl für den Ordner zurückgibt; behandeln Sie diese Angabe daher als optional und nicht als maßgeblich. Dieser Endpunkt erfordert ein verbundenes Konto vom Typ Google; der Pfad ist nur für GoogleAccount-Verbindungen gültig.

Parameter

Pfad

Antworten