Listings APIListings API
Entrar
POST/api/v4/connected-accounts/disconnect-google

Desconectar uma conta do Google

Desconecta por completo uma conta conectada do Google Business Profile da sua conta da Listings API.

Requer uma chave de API. Consulte Autenticação para ver o formato do cabeçalho e a rotação de chaves.

Parâmetros

Corpo

NomeTipoObrigatórioDescrição
inputobjectobrigatórioWrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstringobrigatórioUUID of the connected Google account to disconnect. The whole account is disconnected.

Exemplo de requisição

Corpo pronto para colar. Substitua os IDs e valores de exemplo pelos seus.

Request body
{  "input": {    "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"  }}

Respostas

200Request accepted. `success: true` confirms the disconnect was processed.
Response
{  "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.

Rompe o vínculo entre uma conta conectada do Google Business Profile e sua conta da Listings API. Após a desconexão, as listagens que eram sincronizadas por meio dessa conta deixam de receber atualizações da Listings API.

Estrutura da requisição. O corpo deve estar dentro de um objeto input cujo único campo é connectedAccountId. Esta é uma operação de tudo ou nada: toda a conta do Google e todos os locais vinculados por meio dela são desconectados. Não há campo locationIds; ele é rejeitado pelo esquema. Para desvincular a listagem de um único local e manter a conta conectada, use o endpoint disconnect-listing.

Caso de uso: encerramento completo quando um cliente sai. Envie connectedAccountId para desfazer toda a conexão em uma única chamada. Essa é a maneira adequada de revogar o acesso da Listings API depois que um cliente cancela o serviço ou transfere a propriedade de sua conta do Google.

Caso de uso: encerramento de uma conexão com falha. Se uma conexão com o Google apresentar erros de credenciais que uma nova autenticação não consegue resolver, desconecte-a aqui e gere um novo link com o endpoint connect-google. Para contas do Facebook, use o endpoint disconnect-facebook, que aceita a mesma estrutura de requisição. Observe que uma resposta success: true é retornada mesmo para um connectedAccountId desconhecido, portanto, interprete o sucesso como "a requisição foi processada", e não como prova de que uma conexão ativa foi removida; confirme o estado da conta com GET /connected-accounts se você precisar ter certeza.

Este endpoint altera uma conexão ativa e revoga o acesso da Listings API ao Google. A estrutura da requisição e o exemplo de resposta acima são documentados com base na especificação da API; a chamada não é executada com dados de produção.

Request
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"    }  }'
Run in playground