Getting started with the Policy Service API

L' Policy Service API consente di creare e gestire diverse 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' Policy Service API.

Prerequisiti

L'utilizzo della guida per gli sviluppatori richiede una buona conoscenza dei vari Experience Platform servizi 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 del cliente.
  • 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 Policy Service 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 JSON di esempio restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, vedete la sezione come leggere chiamate API di esempio nella guida alla Experience Platform risoluzione dei problemi.

Intestazioni necessarie

La documentazione API richiede inoltre di aver completato l'esercitazione di autenticazione per effettuare correttamente le chiamate agli Platform endpoint. Completando l'esercitazione sull'autenticazione vengono forniti i valori per ciascuna delle intestazioni richieste nelle chiamate Experience Platform API, 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, comprese 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 avrà luogo l'operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE

Per ulteriori informazioni sulle sandbox in Platform, consultate la documentazione sulla panoramica dellasandbox.

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' Policy Service API, tutti i criteri e le azioni di marketing sono denominati o core custom risorse.

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 core risorse, mentre le operazioni di elenco, ricerca e aggiornamento (POST, PUT, PATCHe DELETE) sono disponibili per custom le risorse.

Passaggi successivi

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

In questa pagina