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

NOTA

Per ulteriori informazioni sulle sandbox in Platform, vedere documentazione di panoramica sulla sandbox.

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.