Documentazione Experience Platform Guida alle destinazioni

Creare una richiesta di pubblicazione di destinazione

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Destinazioni

Creato per:

Amministratore
Utente

IMPORTANT

Devi utilizzare questo endpoint API solo se invii una destinazione prodotta (pubblica), che dovrà essere utilizzata da altri clienti Experience Platform. Se crei una destinazione privata per uso personale, non è necessario inviare formalmente la destinazione utilizzando l’API di pubblicazione.

IMPORTANT

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

Dopo aver configurato e testato la destinazione, puoi inviarla ad Adobe per la revisione e la pubblicazione. Leggi Invia per rivedere una destinazione creata in Destination SDK per tutti gli altri passaggi da eseguire durante il processo di invio della destinazione.

Utilizza l’endpoint API per la pubblicazione delle destinazioni per inviare una richiesta di pubblicazione quando:

In qualità di partner di Destination SDK, desideri rendere la tua destinazione prodotta disponibile in tutte le organizzazioni di Experienci Platform per tutti i clienti di Experienci Platform da utilizzare;
Hai apportato qualsiasi aggiornamento alle tue configurazioni. Gli aggiornamenti della configurazione vengono rispecchiati nella destinazione solo dopo l’invio di una nuova richiesta di pubblicazione, approvata dal team di Experienci Platform.

IMPORTANT

Tutti i nomi e i valori dei parametri supportati da Destination SDK sono con distinzione tra maiuscole e minuscole. Per evitare errori di distinzione tra maiuscole e minuscole, utilizza i nomi e i valori dei parametri esattamente come mostrato nella documentazione.

Guida introduttiva alle operazioni API di pubblicazione di destinazione get-started

Prima di continuare, consulta la guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente chiamate all'API, tra cui come ottenere l'autorizzazione di authoring della destinazione richiesta e le intestazioni richieste.

Invia una configurazione di destinazione per la pubblicazione create

È possibile inviare una configurazione di destinazione per la pubblicazione effettuando una richiesta POST all'endpoint /authoring/destinations/publish.

Formato API

POST /authoring/destinations/publish

Richiesta

La richiesta seguente invia una destinazione per la pubblicazione, tra le organizzazioni configurate dai parametri forniti nel payload. Il payload seguente include tutti i parametri accettati dall'endpoint /authoring/destinations/publish.

code language-shell

code language-shell
`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" }`

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

table 0-row-3 1-row-3 2-row-3 layout-auto
Parametro	Tipo	Descrizione
`destinationId`	Stringa	ID di destinazione della configurazione di destinazione che si sta inviando per la pubblicazione. Ottenere l'ID di destinazione di una configurazione di destinazione utilizzando la chiamata API per recuperare una configurazione di destinazione.
`destinationAccess`	Stringa	Utilizza `ALL` per far apparire la tua destinazione nel catalogo per tutti i clienti di Experience Platform.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 201 con i dettagli della richiesta di pubblicazione di destinazione.

Gestione degli errori API

Gli endpoint API di Destination SDK 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

Dopo aver letto questo documento, ora sai come inviare una richiesta di pubblicazione per la tua destinazione. Il team Adobe Experience Platform esaminerà la richiesta di pubblicazione e ti contatterà entro cinque giorni lavorativi.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6