Eliminare un account di destinazione utilizzando l’API del servizio Flusso

Destinations sono integrazioni predefinite con piattaforme di destinazione che consentono l’attivazione diretta dei dati da Adobe Experience Platform. Puoi utilizzare le destinazioni per attivare i dati noti e sconosciuti per campagne di marketing cross-channel, campagne e-mail, pubblicità mirata e molti altri casi d’uso.

Prima di attivare i dati, devi connetterti alla destinazione impostando prima un account di destinazione. Questo tutorial illustra i passaggi necessari per eliminare gli account di destinazione che non sono più necessari utilizzando Flow Service API.

NOTE
L’eliminazione degli account di destinazione è attualmente supportata solo dall’API del servizio Flusso. Gli account di destinazione non possono essere eliminati utilizzando l’interfaccia utente di Experience Platform.

Introduzione get-started

Questo tutorial richiede un ID di connessione valido. L’ID di connessione rappresenta la connessione dell’account alla destinazione. Se non disponi di un ID di connessione valido, seleziona la destinazione desiderata dal catalogo delle destinazioni e segui i passaggi descritti per connetterti alla destinazione prima di provare questa esercitazione.

Questo tutorial richiede anche una buona conoscenza dei seguenti componenti di Adobe Experience Platform:

  • Destinazioni: Destinations sono integrazioni predefinite con piattaforme di destinazione che consentono l'attivazione diretta dei dati da Adobe Experience Platform. Puoi utilizzare le destinazioni per attivare i dati noti e sconosciuti per campagne di marketing cross-channel, campagne e-mail, pubblicità mirata e molti altri casi d’uso.
  • Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza di Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per eliminare correttamente un account di destinazione utilizzando l'API Flow Service.

Lettura delle chiamate API di esempio reading-sample-api-calls

Questo tutorial fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richieste formattati correttamente. Viene inoltre fornito un codice JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione su come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Raccogliere i valori per le intestazioni richieste gather-values-for-required-headers

Per effettuare chiamate alle API Platform, devi prima completare l'esercitazione di autenticazione. Completando il tutorial sull’autenticazione si ottengono i valori per ciascuna delle intestazioni richieste in tutte le chiamate API di Experience Platform, come mostrato di seguito:

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

Tutte le risorse in Experience Platform, incluse quelle appartenenti a Flow Service, sono isolate in sandbox virtuali specifiche. Tutte le richieste alle API Platform richiedono un'intestazione che specifichi il nome della sandbox in cui verrà eseguita l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Se l'intestazione x-sandbox-name non è specificata, le richieste vengono risolte nella sandbox prod.

Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un’intestazione di tipo multimediale aggiuntiva:

  • Content-Type: application/json

Trova l’ID di connessione dell’account di destinazione da eliminare find-connection-id

NOTE
Questa esercitazione utilizza come esempio la destinazione dirigibile, ma i passaggi descritti si applicano a una qualsiasi delle destinazioni disponibili.

Il primo passaggio nell’eliminazione di un account di destinazione consiste nell’individuare l’ID di connessione corrispondente all’account di destinazione che desideri eliminare.

Nell'interfaccia utente di Experience Platform, passa a Destinazioni > Account e seleziona l'account da eliminare selezionando il numero nella colonna Destinazioni.

Seleziona account di destinazione da eliminare

Successivamente, puoi recuperare l’ID di connessione dell’account di destinazione dall’URL nel browser.

Recupera ID connessione dallURL

Elimina connessione delete-connection

IMPORTANT
Prima di eliminare l’account di destinazione, devi eliminare tutti i flussi di dati esistenti dall’account di destinazione.
Per eliminare i flussi di dati esistenti, consulta le pagine seguenti:

Dopo aver ottenuto un ID di connessione e aver verificato che non esistono flussi di dati per l'account di destinazione, eseguire una richiesta DELETE all'API Flow Service.

Formato API

DELETE /connections/{CONNECTION_ID}
Parametro
Descrizione
{CONNECTION_ID}
Valore id univoco per la connessione da eliminare.

Richiesta

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}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 204 (nessun contenuto) e un corpo vuoto. Puoi confermare l’eliminazione tentando una richiesta di ricerca (GET) alla connessione. L’API restituirà un errore HTTP 404 (Non trovato), che indica che l’account di destinazione è stato eliminato.

Gestione degli errori API api-error-handling

Gli endpoint API in questa esercitazione seguono i principi generali dei messaggi di errore API di Experience Platform. Consulta Codici di stato API e errori di intestazione della richiesta nella guida alla risoluzione dei problemi di Platform.

Passaggi successivi

Seguendo questa esercitazione, hai usato correttamente l'API Flow Service per eliminare gli account di destinazione esistenti. Per ulteriori informazioni sull'utilizzo delle destinazioni, consulta la panoramica delle destinazioni.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6