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

Disconnetti una sede da Apple Business Connect

Scollega una sede dall'account Apple Business del proprietario. La sede resta su Apple Maps ed è pubblicata tramite l'account ListingsAPI.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Corpo

NomeTipoObbligatorioDescrizione
inputobjectobbligatorioWrapper object. The entire request body must be nested under `input`.
input.locationIdstringobbligatorioBase64-encoded Relay ID of the one location to disconnect.
input.sitestringobbligatorioSet to `APPLE`.

Richiesta di esempio

Corpo pronto da incollare. Sostituisci gli ID e i valori segnaposto con i tuoi.

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

Risposte

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`).

Usa questa operazione quando un cliente interrompe il rapporto e porta con sé il proprio account Apple Business. La sede rimane nel tuo account e su Apple Maps: gli aggiornamenti successivi vengono pubblicati tramite l'account Apple Business Connect di ListingsAPI e Apple verifica i dati inviati prima di pubblicarli. Le connessioni della sede alle altre piattaforme di pubblicazione non vengono modificate.

Una sede senza una connessione Apple attiva restituisce SY10057, quindi success: true significa che è stata rimossa una connessione. La chiamata gestisce una singola sede; usa un ciclo per disconnetterne più di una.

Per pubblicare di nuovo tramite l'account del proprietario, inviagli un nuovo link da Connetti una sede ad Apple Business Connect.

Questa pagina documenta il caso site: "APPLE" di Disconnetti una singola sede da una piattaforma di pubblicazione.

Questo endpoint modifica una connessione attiva. La richiesta e la risposta di esempio riportate sopra sono esempi.

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