Desconectar una cuenta de Google

Rompe el vínculo entre una cuenta de Google Business Profile conectada y tu cuenta de Listings API. Una vez desconectada, las fichas que se sincronizaban a través de esa cuenta dejan de recibir actualizaciones de Listings API.

Estructura de la solicitud. El cuerpo debe estar contenido en un objeto input cuyo único campo sea connectedAccountId. Esta es una operación de todo o nada: se desconectan toda la cuenta de Google y todas las ubicaciones vinculadas a través de ella. No hay ningún campo locationIds; el esquema lo rechaza. Para desvincular la ficha de una sola ubicación y mantener la cuenta conectada, usa el endpoint disconnect-listing.

Caso de uso: desconexión completa cuando un cliente se da de baja. Envía connectedAccountId para eliminar toda la conexión en una sola llamada. Esta es la forma adecuada de revocar el acceso de Listings API después de que un cliente se dé de baja o transfiera la titularidad de su cuenta de Google.

Caso de uso: desconexión de una conexión defectuosa. Si una conexión de Google tiene errores de credenciales que no se pueden resolver con una nueva autenticación, desconéctala aquí y genera un nuevo enlace con el endpoint connect-google. Para las cuentas de Facebook, usa el endpoint disconnect-facebook, que acepta la misma estructura de solicitud. Ten en cuenta que se devuelve una respuesta success: true incluso si connectedAccountId es desconocido, así que interpreta el resultado satisfactorio como «la solicitud se ha procesado», no como una prueba de que se haya eliminado una conexión activa; confirma el estado de la cuenta con GET /connected-accounts si necesitas tener certeza.

Este endpoint modifica una conexión activa y revoca el acceso de Listings API a Google. La estructura de la solicitud y la respuesta de ejemplo anteriores se documentan a partir de la especificación de la API; la llamada no se ejecuta sobre datos de producción.