Listings APIListings API
Entrar
POST/api/v4/locations/oauth-disconnect

Desconectar um local do Apple Business Connect

Remove a conexão de um local com a conta do Apple Business do proprietário. O local permanece no Apple Maps e é publicado por meio da conta do ListingsAPI.

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.locationIdstringobrigatórioBase64-encoded Relay ID of the one location to disconnect.
input.sitestringobrigatórioSet to `APPLE`.

Exemplo de requisição

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

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "site": "APPLE"  }}

Respostas

200Connection removed. Response key `disconnectConnectedAccountsLocations`.
Response
{  "data": {    "disconnectConnectedAccountsLocations": {      "clientMutationId": null,      "success": true,      "errors": null    }  }}
401Unauthenticated, missing or invalid API key.
403The key is valid but not permitted to disconnect this location (`SY90003`).

Use esta opção quando um cliente sair e levar consigo a própria conta do Apple Business. O local permanece na sua conta e no Apple Maps: as atualizações posteriores são publicadas por meio da conta do Apple Business Connect do ListingsAPI, e a Apple verifica o envio antes de publicá-lo. As conexões do local com outras plataformas de publicação não são afetadas.

Um local sem conexão ativa com a Apple retorna SY10057, portanto success: true significa que uma conexão foi removida. A chamada processa um local; use um loop para desconectar vários.

Para publicar novamente por meio da conta do proprietário, envie a ele um novo link de Conectar um local ao Apple Business Connect.

Esta página documenta o caso site: "APPLE" de Desconectar um local de uma plataforma de publicação.

Este endpoint altera uma conexão em produção. A solicitação e a resposta de exemplo acima são exemplos.

Request
curl -X POST 'https://listingsapi.com/api/v4/locations/oauth-disconnect' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "site": "APPLE"    }  }'
Run in playground