Guida introduttiva a Policy Service API
Il Policy Service API consente di creare e gestire varie risorse relative alla governance dei dati di Adobe Experience Platform. Questo documento fornisce un’introduzione ai concetti di base che è necessario conoscere prima di tentare di effettuare chiamate al Policy Service API.
Prerequisiti
L’utilizzo della guida per sviluppatori richiede una buona conoscenza delle varie Experience Platform servizi coinvolti nell’utilizzo delle funzionalità di governance dei dati. Prima di iniziare a utilizzare Policy Service API, consulta la documentazione relativa ai seguenti servizi:
- Governance dei dati: framework tramite il quale Experience Platform applica la conformità all’utilizzo dei dati.
- Experience Data Model (XDM) System: il quadro standardizzato mediante il quale Experience Platform organizza i dati sull’esperienza del cliente.
- Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
- Sandbox: Experience Platform fornisce sandbox virtuali che permettono di suddividere un singolo Platform in ambienti virtuali separati, per facilitare lo sviluppo e l’evoluzione delle applicazioni di esperienza digitale.
Lettura delle chiamate API di esempio
Il Policy Service La documentazione API 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 esempi di chiamate API nel Experience Platform guida alla risoluzione dei problemi.
Intestazioni richieste
La documentazione API richiede inoltre di aver completato tutorial sull’autenticazione per effettuare correttamente chiamate a Platform endpoint. Il completamento del tutorial sull’autenticazione fornisce i valori per ciascuna delle intestazioni richieste in Experience Platform Chiamate API, 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, inclusi quelli appartenenti alla governance dei dati, sono isolati in specifiche sandbox virtuali. Tutte le richieste a Platform Le API richiedono un’intestazione che specifichi il nome della sandbox in cui verrà eseguita l’operazione:
x-sandbox-name: {SANDBOX_NAME}
Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un’intestazione aggiuntiva:
Content-Type: application/json
Risorse core e personalizzate
All'interno del Policy Service API, tutti i criteri e le azioni di marketing sono denominati core o custom risorse.
core le risorse sono quelle definite e mantenute dall'Adobe, mentre custom Le risorse sono quelle create e gestite dall’organizzazione e sono quindi uniche e visibili solo all’organizzazione. Di conseguenza, le operazioni di elenco e ricerca (GET) sono le uniche operazioni consentite il core risorse, mentre le operazioni di elenco, ricerca e aggiornamento (POST, PUT, PATCH, e DELETE) sono disponibili per custom risorse.
Passaggi successivi
Per iniziare a effettuare chiamate utilizzando l’API del servizio criteri, seleziona una delle guide degli endpoint disponibili.