Guida introduttiva all'API Policy Service

L'API Policy Service consente di creare e gestire varie risorse correlate ad Adobe Experience Platform Data Governance. Questo documento fornisce un'introduzione ai concetti di base da conoscere prima di tentare di effettuare chiamate all'API Policy Service.

Prerequisiti

L'utilizzo della guida per gli sviluppatori richiede una buona conoscenza dei vari servizi Experience Platform coinvolti nell'utilizzo delle funzionalità di governance dei dati. Prima di iniziare a lavorare con Policy Service API, consulta la documentazione relativa ai seguenti servizi:

• Data Governance: Il framework in base al quale Experience Platform viene applicata la conformità all'utilizzo dei dati.
• Experience Data Model (XDM) System: Il framework standard con cui Experience Platform organizzare i dati relativi all'esperienza dei clienti.
• Real-time Customer Profile: Fornisce un profilo di consumo unificato e in tempo reale basato su dati aggregati provenienti da più origini.
• Sandbox: Experience Platform fornisce sandbox virtuali che dividono una singola Platform istanza in ambienti virtuali separati per sviluppare e sviluppare applicazioni per esperienze digitali.

Lettura di chiamate API di esempio

La documentazione API Policy Service 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 JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consultate la sezione relativa a come leggere chiamate API di esempio nella guida alla risoluzione dei problemi di Experience Platform.

Intestazioni necessarie

La documentazione API richiede inoltre di aver completato l' esercitazione di autenticazione per effettuare correttamente le chiamate agli endpoint Platform. Completando l'esercitazione sull'autenticazione, vengono forniti i valori per ciascuna delle intestazioni richieste nelle chiamate API Experience Platform, come illustrato di seguito:

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

Tutte le risorse in Experience Platform, incluse quelle appartenenti a Data Governance, sono isolate in sandbox virtuali specifiche. Tutte le richieste alle Platform API richiedono un'intestazione che specifica 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 dell'API Policy Service, tutti i criteri e le azioni di marketing sono denominati risorse core o custom.

core le risorse sono quelle definite e gestite Adobe, mentre custom le risorse sono quelle create e mantenute dalla vostra organizzazione e sono pertanto uniche e visibili esclusivamente alla vostra organizzazione IMS. Di conseguenza, le operazioni di elenco e ricerca (GET) sono le uniche operazioni consentite sulle risorse core, mentre le operazioni di elencazione, ricerca e aggiornamento (POST, PUT, PATCH e DELETE) sono disponibili per le risorse custom.

Passaggi successivi

Per iniziare a effettuare chiamate tramite l'API di Policy Service, selezionate una delle guide endpoint disponibili.