/api/v4/locations/oauth-disconnectDéconnecter un établissement d’Apple Business Connect
Déconnecte un établissement du compte Apple Business de son propriétaire. Il reste sur Apple Maps et est publié via le compte ListingsAPI.
Paramètres
Corps
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| input | object | obligatoire | Wrapper object. The entire request body must be nested under `input`. |
| input.locationId | string | obligatoire | Base64-encoded Relay ID of the one location to disconnect. |
| input.site | string | obligatoire | Set to `APPLE`. |
Exemple de requête
Corps prêt à coller. Remplacez les identifiants et valeurs d’exemple par les vôtres.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "site": "APPLE" }}Réponses
200Connection removed. Response key `disconnectConnectedAccountsLocations`.
{ "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`).
Utilisez cette opération lorsqu’un client part en conservant son compte Apple Business. L’établissement reste dans votre compte et sur Apple Maps : les mises à jour ultérieures sont publiées via le compte Apple Business Connect de ListingsAPI, et Apple vérifie la soumission avant de la publier. Les autres connexions de l’établissement aux plateformes de publication ne sont pas affectées.
Un établissement sans connexion Apple active renvoie SY10057 ; success: true signifie donc qu’une connexion a été supprimée. L’appel traite un seul établissement ; utilisez une boucle pour en déconnecter plusieurs.
Pour publier à nouveau via le compte du propriétaire, envoyez-lui un nouveau lien depuis Connecter un établissement à Apple Business Connect.
Cette page documente le cas site: "APPLE" de Déconnecter un établissement d’une plateforme de publication.
Cet endpoint modifie une connexion en service. La requête et la réponse présentées ci-dessus sont des exemples.
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" } }'