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 destinationskonton som inte längre behövs med hjälp av Flow Service API.

OBSERVERA

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

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 på menyn målkatalog och följa de steg som beskrivs nedan för att ansluta till målet innan du provar den här självstudiekursen.

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 enda Platform till separata virtuella miljöer för att utveckla och utveckla applikationer 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 hjälp av Flow Service API.

Läser exempel-API-anrop

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 konventionerna som används i dokumentationen för exempel-API-anrop finns i avsnittet om läsa exempel-API-anrop i Experience Platform felsökningsguide.

Samla in värden för obligatoriska rubriker

För att ringa Platform API:er måste du först slutföra självstudiekurs om autentisering. När du är klar med självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i alla Experience Platform API-anrop enligt nedan:

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

Alla resurser i Experience Platform, inklusive sådana som tillhör Flow Service, isoleras till specifika virtuella sandlådor. Alla förfrågningar 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}
OBSERVERA

Om x-sandbox-name ingen rubrik har angetts, begäranden har lösts under prod sandlåda.

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

OBSERVERA

I den här självstudiekursen används Luftfartygets destination som ett exempel, men de steg som beskrivs ovan 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 går du till Destinations > Accounts och välj det konto du vill ta bort genom att markera numret i Destinations kolumn.

Välj målkonto att ta 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

VIKTIGT

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 destinationskontot utför du en DELETE-begäran till Flow Service API.

API-format

DELETE /connections/{CONNECTION_ID}
Parameter Beskrivning
{CONNECTION_ID} 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:t returnerar ett HTTP 404-fel (Hittades inte) som anger att målkontot har tagits bort.

API-felhantering

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

Nästa steg

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

På denna sida