Disconnettere un account Google

Interrompe il collegamento tra un account Google Business Profile collegato e il tuo account Listings API. Una volta disconnesso, le schede sincronizzate tramite quell'account smettono di ricevere aggiornamenti da Listings API.

Struttura della richiesta. Il corpo deve essere racchiuso in un oggetto input il cui unico campo è connectedAccountId. Questa operazione non consente disconnessioni parziali: vengono disconnessi l'intero account Google e tutte le sedi collegate tramite esso. Non è previsto alcun campo locationIds; lo schema lo rifiuta. Per scollegare la scheda di una singola sede mantenendo l'account collegato, usa l'endpoint disconnect-listing.

Caso d'uso: disconnessione completa quando un cliente lascia il servizio. Invia connectedAccountId per rimuovere l'intero collegamento con una sola chiamata. Questo è il modo corretto per revocare l'accesso di Listings API dopo che un cliente abbandona il servizio o trasferisce la proprietà del proprio account Google.

Caso d'uso: rimozione di un collegamento non funzionante. Se un collegamento Google presenta errori nelle credenziali che una nuova autenticazione non riesce a risolvere, disconnettilo qui e genera un nuovo link con l'endpoint connect-google. Per gli account Facebook, usa l'endpoint disconnect-facebook, che accetta la stessa struttura della richiesta. Tieni presente che viene restituita una risposta success: true anche per un connectedAccountId sconosciuto, quindi interpreta l'esito positivo come "la richiesta è stata elaborata", non come prova che un collegamento attivo sia stato rimosso; verifica lo stato dell'account con GET /connected-accounts se ti serve una conferma certa.

Questo endpoint modifica un collegamento attivo e revoca l'accesso di Listings API a Google. La struttura della richiesta e la risposta di esempio riportate sopra sono documentate sulla base della specifica API; la chiamata non viene eseguita sui dati di produzione.