Dokumentation Experience Platform Användarhandbok om destinationer

Skapa en publiceringsbegäran för destinationen

16 juli 2024

Ämnen:
Destinationer

Skapat för:

Administratör
Användare

IMPORTANT

Du behöver bara använda den här API-slutpunkten om du skickar en produkterad (offentlig) destination som ska användas av andra Experience Platform-kunder. Om du skapar ett privat mål för eget bruk behöver du inte skicka målet formellt med publicerings-API:t.

IMPORTANT

API-slutpunkt: platform.adobe.io/data/core/activation/authoring/destinations/publish

När du har konfigurerat och testat destinationen kan du skicka den till Adobe för granskning och publicering. Läs Skicka för granskning av ett mål som har skapats i Destination SDK för alla andra steg som du måste göra som en del av målöverföringsprocessen.

Använd API-slutpunkten för publiceringsmål för att skicka en publiceringsbegäran när:

Som Destination SDK partner vill ni att alla kunder i Experience Platform ska kunna använda er av den producerade destinationen,
Du gör alla uppdateringar till dina konfigurationer. Konfigurationsuppdateringar visas endast i målet när du har skickat in en ny publiceringsbegäran som har godkänts av Experience Platform-teamet.

IMPORTANT

Alla parameternamn och värden som stöds av Destinationen SDK är skiftlägeskänsliga. Undvik skiftlägeskänslighetsfel genom att använda parameternamn och värden exakt som de visas i dokumentationen.

Komma igång med API-åtgärder för målpublicering

Innan du fortsätter bör du läsa igenom kom igång-guiden för att få viktig information som du behöver känna till för att kunna ringa anrop till API:t, inklusive hur du får nödvändig behörighet för målredigering och nödvändiga rubriker.

Skicka en målkonfiguration för publicering

Du kan skicka en målkonfiguration för publicering genom att göra en POST-förfrågan till slutpunkten /authoring/destinations/publish.

API-format

POST /authoring/destinations/publish

Begäran

Följande begäran skickar en publiceringsdestination i de organisationer som konfigurerats med parametrarna i nyttolasten. Nyttolasten nedan innehåller alla parametrar som accepteras av slutpunkten /authoring/destinations/publish.

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations/publish \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "destinationAccess":"ALL"
}

Parameter

Typ

Beskrivning

destinationId

Sträng

Mål-ID för målkonfigurationen som du skickar för publicering. Hämta mål-ID:t för en målkonfiguration med API-anropet Hämta en målkonfiguration.

destinationAccess

Sträng

Använd ALL för att ditt mål ska visas i katalogen för alla Experience Platform-kunder.

svar

Ett lyckat svar returnerar HTTP-status 201 med information om din målpubliceringsbegäran.

API-felhantering

Destination SDK-API-slutpunkter 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

När du har läst det här dokumentet vet du nu hur du skickar en publiceringsbegäran för ditt mål. Adobe Experience Platform-teamet granskar din publiceringsförfrågan och kommer tillbaka till dig inom fem arbetsdagar.

recommendation-more-help