Eliminar una cuenta de destino mediante la API de servicio de flujo

Destinations son integraciones prediseñadas con plataformas de destino que permiten la activación perfecta de datos de Adobe Experience Platform. Puede utilizar destinos para activar los datos conocidos y desconocidos en campañas de marketing en canales múltiples, campañas de correo electrónico, publicidad de destino y muchos otros casos de uso.

Antes de activar los datos, debe conectarse al destino configurando primero una cuenta de destino. Este tutorial trata los pasos para eliminar las cuentas de destino que ya no se necesitan mediante la Flow Service API.

NOTA

Actualmente, la eliminación de cuentas de destino solo se admite en la API de servicio de flujo. Las cuentas de destino no se pueden eliminar mediante la interfaz de usuario del Experience Platform.

Primeros pasos

Este tutorial requiere que tenga un ID de conexión válido. El ID de conexión representa la conexión de la cuenta al destino. Si no tiene un ID de conexión válido, seleccione el destino que desee en el catálogo de destinos y siga los pasos descritos para conectarse al destino antes de intentar este tutorial.

Este tutorial también requiere que tenga una comprensión práctica de los siguientes componentes de Adobe Experience Platform:

  • Destinos: Destinations son integraciones prediseñadas con plataformas de destino que permiten la activación perfecta de datos de Adobe Experience Platform. Puede utilizar destinos para activar los datos conocidos y desconocidos en campañas de marketing en canales múltiples, campañas de correo electrónico, publicidad de destino y muchos otros casos de uso.
  • Sandboxes: Experience Platform proporciona entornos limitados virtuales que dividen un solo Platform en entornos virtuales independientes para ayudar a desarrollar y desarrollar aplicaciones de experiencia digital.

Las secciones siguientes proporcionan información adicional que deberá conocer para eliminar correctamente una cuenta de destino mediante la Flow Service API.

Leer llamadas de API de ejemplo

Este tutorial proporciona llamadas de API de ejemplo para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.

Recopilar valores para encabezados necesarios

Para realizar llamadas a Platform API, primero debe completar la variable tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todos los Experience Platform Llamadas de API, como se muestra a continuación:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Todos los recursos de Experience Platform, incluidas las pertenecientes a Flow Service, están aisladas para entornos limitados virtuales específicos. Todas las solicitudes a Platform Las API requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

Si la variable x-sandbox-name no se ha especificado, las solicitudes se resuelven en la sección prod simulador de pruebas.

Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado de tipo de medio adicional:

  • Content-Type: application/json

Busque el ID de conexión de la cuenta de destino que desea eliminar

NOTA

Este tutorial utiliza la variable Destino de la aeronave como ejemplo, pero los pasos descritos se aplican a cualquiera de los destinos disponibles.

El primer paso para eliminar una cuenta de destino es averiguar el ID de conexión que corresponde a la cuenta de destino que desea eliminar.

En la interfaz de usuario del Experience Platform, vaya a Destinos > Cuentas y seleccione la cuenta que desee eliminar seleccionando el número en la variable Destinos para abrir el Navegador.

Seleccionar cuenta de destino para eliminar

A continuación, puede recuperar el ID de conexión de la cuenta de destino desde la dirección URL en el explorador.

Recuperar el ID de conexión de la URL

Eliminar conexión

IMPORTANTE

Antes de eliminar la cuenta de destino, debe eliminar los flujos de datos existentes en la cuenta de destino.
Para eliminar flujos de datos existentes, consulte las páginas siguientes:

Una vez que tenga un ID de conexión y se haya asegurado de que no existen flujos de datos en la cuenta de destino, realice una solicitud de DELETE a la Flow Service API.

Formato de API

DELETE /connections/{CONNECTION_ID}
Parámetro Descripción
{CONNECTION_ID} El único id para la conexión que desea eliminar.

Solicitud

curl -X DELETE \
    'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 204 (sin contenido) y un cuerpo en blanco. Puede confirmar la eliminación intentando realizar una solicitud de búsqueda (GET) a la conexión. La API devolverá un error HTTP 404 (no encontrado), que indica que la cuenta de destino se ha eliminado.

Gestión de errores de API

Los extremos de API de este tutorial siguen los principios generales del mensaje de error de la API del Experience Platform. Consulte Códigos de estado de API y errores en el encabezado de la solicitud en la guía de solución de problemas de Platform.

Pasos siguientes

Al seguir este tutorial, ha utilizado correctamente la variable Flow Service para eliminar cuentas de destino existentes. Para obtener más información sobre el uso de destinos, consulte la información general sobre destinos.

En esta página