Déconnecter un compte Google

Rompt le lien entre un compte Google Business Profile connecté et votre compte Listings API. Une fois le compte déconnecté, les fiches synchronisées par son intermédiaire ne reçoivent plus de mises à jour de Listings API.

Structure de la requête. Le corps doit être encapsulé dans un objet input dont le seul champ est connectedAccountId. Cette opération est indivisible : l'ensemble du compte Google et tous les établissements qui y sont associés sont déconnectés. Il n'existe aucun champ locationIds ; le schéma le rejette. Pour dissocier la fiche d'un seul établissement tout en gardant le compte connecté, utilisez l'endpoint disconnect-listing.

Cas d'utilisation : déconnexion complète lors du départ d'un client. Envoyez connectedAccountId pour supprimer entièrement la connexion en un seul appel. C'est la méthode appropriée pour révoquer l'accès de Listings API lorsqu'un client résilie son abonnement ou transfère la propriété de son compte Google.

Cas d'utilisation : suppression d'une connexion défaillante. Si une connexion Google présente des erreurs d'identifiants qu'une nouvelle authentification ne permet pas de résoudre, déconnectez-la ici et générez un nouveau lien avec l'endpoint connect-google. Pour les comptes Facebook, utilisez l'endpoint disconnect-facebook, qui accepte la même structure de requête. Notez qu'une réponse success: true est renvoyée même pour un connectedAccountId inconnu : interprétez donc la réussite comme « la requête a été traitée », et non comme la preuve qu'une connexion active a été supprimée ; vérifiez l'état du compte avec GET /connected-accounts si vous avez besoin d'une certitude.

Cet endpoint modifie une connexion active et révoque l'accès de Listings API à Google. La structure de la requête et l'exemple de réponse ci-dessus sont documentés à partir de la spécification de l'API ; l'appel n'est pas exécuté sur des données de production.