/api/v4/connected-accounts/disconnect-googleEin Google-Konto trennen
Trennt ein verbundenes Google Business Profile-Konto vollständig von Ihrem Listings API-Konto.
Parameter
Body
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| input | object | erforderlich | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | erforderlich | UUID of the connected Google account to disconnect. The whole account is disconnected. |
Beispielanfrage
Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}Antworten
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "gmbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
Trennt die Verbindung zwischen einem verbundenen Google Business Profile-Konto und Ihrem Listings API-Konto. Nach der Trennung erhalten Einträge, die über dieses Konto synchronisiert wurden, keine Aktualisierungen mehr von Listings API.
Anfragestruktur. Der Body muss in ein input-Objekt eingebettet sein, dessen einziges Feld connectedAccountId ist. Dieser Vorgang folgt dem Ganz-oder-gar-nicht-Prinzip: Das gesamte Google-Konto und alle darüber verknüpften Standorte werden getrennt. Es gibt kein locationIds-Feld; es wird vom Schema abgelehnt. Um den Eintrag eines einzelnen Standorts zu trennen und das Konto weiterhin verbunden zu lassen, verwenden Sie den disconnect-listing-Endpunkt.
Anwendungsfall: vollständiges Offboarding, wenn ein Kunde die Zusammenarbeit beendet. Senden Sie connectedAccountId, um die gesamte Verbindung mit einem einzigen Aufruf zu trennen. So entziehen Sie Listings API den Zugriff ordnungsgemäß, nachdem ein Kunde die Zusammenarbeit beendet oder die Inhaberschaft seines Google-Kontos übertragen hat.
Anwendungsfall: Offboarding einer fehlerhaften Verbindung. Wenn bei einer Google-Verbindung Fehler mit den Zugangsdaten auftreten, die sich durch eine erneute Authentifizierung nicht beheben lassen, trennen Sie die Verbindung hier und erstellen Sie mit dem connect-google-Endpunkt einen neuen Link. Verwenden Sie für Facebook-Konten den disconnect-facebook-Endpunkt, der dieselbe Anfragestruktur verwendet. Beachten Sie, dass auch bei einem unbekannten connectedAccountId eine success: true-Antwort zurückgegeben wird. Werten Sie einen Erfolg daher als „Die Anfrage wurde verarbeitet“ und nicht als Nachweis dafür, dass eine aktive Verbindung entfernt wurde; überprüfen Sie den Zustand des Kontos mit GET /connected-accounts, wenn Sie Gewissheit benötigen.
Dieser Endpunkt verändert eine aktive Verbindung und entzieht Listings API den Zugriff auf Google. Die oben gezeigte Anfragestruktur und Beispielantwort sind anhand der API-Spezifikation dokumentiert; der Aufruf wird nicht mit Produktionsdaten ausgeführt.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-google' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'