Listings APIListings API
Iniciar sesión
POST/api/v4/locations/oauth-disconnect

Desconectar una ubicación de Apple Business Connect

Desconecta una ubicación de la cuenta de Apple Business del propietario. Sigue en Apple Maps y se publica desde la cuenta de ListingsAPI.

Requiere una clave de API. Consulta Autenticación para conocer el formato del encabezado y la rotación de claves.

Parámetros

Cuerpo

NombreTipoObligatorioDescripción
inputobjectobligatorioWrapper object. The entire request body must be nested under `input`.
input.locationIdstringobligatorioBase64-encoded Relay ID of the one location to disconnect.
input.sitestringobligatorioSet to `APPLE`.

Solicitud de ejemplo

Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.

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

Respuestas

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

Úsalo cuando un cliente se marche y se lleve su cuenta de Apple Business. La ubicación permanece en tu cuenta y en Apple Maps: las actualizaciones posteriores se publican a través de la cuenta de Apple Business Connect de ListingsAPI, y Apple verifica el envío antes de publicarlo. Las conexiones de la ubicación con otras plataformas de publicación no se ven afectadas.

Una ubicación sin una conexión activa con Apple devuelve SY10057, por lo que success: true significa que se ha eliminado una conexión. La llamada gestiona una sola ubicación; usa un bucle para desconectar varias.

Para volver a publicar a través de la cuenta del propietario, envíale un nuevo enlace desde Conectar una ubicación a Apple Business Connect.

Esta página documenta el caso site: "APPLE" de Desconectar una ubicación de una plataforma de publicación.

Este endpoint modifica una conexión activa. La solicitud y la respuesta de muestra anteriores son ejemplos.

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