Ta bort ett målkonto med API:t för Flow Service

Destinations är färdiga integreringar med målplattformar som möjliggör smidig aktivering av data från Adobe Experience Platform. Ni kan använda destinationer för att aktivera kända och okända data för flerkanalskampanjer, e-postkampanjer, riktad reklam och många andra användningsfall.

Innan du aktiverar data måste du ansluta till målet genom att först konfigurera ett målkonto. I den här självstudiekursen beskrivs stegen för att ta bort målkonton som inte längre behövs med Flow Service API.

NOTE
Det finns endast stöd för att ta bort målkonton i API:t för Flow Service. Det går inte att ta bort destinationskonton med hjälp av användargränssnittet i Experience Platform.

Komma igång get-started

Den här självstudiekursen kräver att du har ett giltigt anslutnings-ID. Anslutnings-ID representerar kontoanslutningen till målet. Om du inte har något giltigt anslutnings-ID väljer du önskat mål i målkatalogen och följer instruktionerna som beskrivs för att ansluta till målet innan du försöker med den här självstudien.

Den här självstudiekursen kräver även att du har en fungerande förståelse för följande komponenter i Adobe Experience Platform:

  • Destinationer: Destinations är färdiga integreringar med målplattformar som möjliggör smidig aktivering av data från Adobe Experience Platform. Ni kan använda destinationer för att aktivera kända och okända data för flerkanalskampanjer, e-postkampanjer, riktad reklam och många andra användningsfall.
  • Sandlådor: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Platform-instans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ta bort ett målkonto med API:t Flow Service.

Läser exempel-API-anrop reading-sample-api-calls

I den här självstudiekursen finns exempel-API-anrop som visar hur du formaterar dina begäranden. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om de konventioner som används i dokumentationen för exempel-API-anrop finns i avsnittet Så här läser du exempel-API-anrop i felsökningsguiden för Experience Platform.

Samla in värden för obligatoriska rubriker gather-values-for-required-headers

För att kunna anropa Platform API:er måste du först slutföra autentiseringssjälvstudiekursen. När du slutför självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i alla Experience Platform API-anrop, vilket visas nedan:

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

Alla resurser i Experience Platform, inklusive de som tillhör Flow Service, isoleras till specifika virtuella sandlådor. Alla begäranden till Platform API:er kräver en rubrik som anger namnet på sandlådan som åtgärden ska utföras i:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Om rubriken x-sandbox-name inte anges löses förfrågningar under sandlådan prod.

Alla begäranden som innehåller en nyttolast (POST, PUT, PATCH) kräver ytterligare en medietypsrubrik:

  • Content-Type: application/json

Hitta anslutnings-ID:t för målkontot som du vill ta bort find-connection-id

NOTE
I den här självstudien används Airship-destinationen som exempel, men de angivna stegen gäller för alla tillgängliga destinationer.

Det första steget i att ta bort ett målkonto är att ta reda på det anslutnings-ID som motsvarar målkontot som du vill ta bort.

I användargränssnittet för Experience Platform bläddrar du till Destinations > Accounts och markerar det konto som du vill ta bort genom att markera numret i kolumnen Destinations.

Välj målkonto som ska tas bort

Därefter kan du hämta anslutnings-ID:t för målkontot från URL:en i webbläsaren.

Hämta anslutnings-ID från URL

Ta bort anslutning delete-connection

IMPORTANT
Innan du tar bort målkontot måste du ta bort alla befintliga dataflöden till målkontot.
Om du vill ta bort befintliga dataflöden kan du läsa sidorna nedan:

När du har ett anslutnings-ID och har säkerställt att det inte finns några dataflöden till målkontot, kan du utföra en DELETE-begäran till Flow Service-API:t.

API-format

DELETE /connections/{CONNECTION_ID}
Parameter
Beskrivning
{CONNECTION_ID}
Det unika id-värdet för anslutningen som du vill ta bort.

Begäran

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

Svar

Ett lyckat svar returnerar HTTP-status 204 (inget innehåll) och en tom brödtext. Du kan bekräfta borttagningen genom att försöka utföra en sökning (GET) på anslutningen. API returnerar ett HTTP 404-fel (Hittades inte) som anger att målkontot har tagits bort.

API-felhantering api-error-handling

API-slutpunkterna i den här självstudiekursen följer de allmänna felmeddelandeprinciperna för Experience Platform API. Se API-statuskoder och begäranrubrikfel i felsökningsguiden för plattformen.

Nästa steg

Genom att följa den här självstudiekursen har du använt API:t Flow Service för att ta bort befintliga målkonton. Mer information om hur du använder mål finns i målöversikten.

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