Guida introduttiva a Policy Service API

La Policy Service L’API ti 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 gli sviluppatori richiede una buona comprensione dei diversi 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:

  • Governance dei dati: Il quadro Experience Platform applica la conformità per l’utilizzo dei dati.
  • Experience Data Model (XDM) System: Il quadro standardizzato Experience Platform organizza i dati sulla customer experience.
  • Real-time Customer Profile: Fornisce un profilo di consumatore unificato e in tempo reale basato su dati aggregati provenienti da più origini.
  • Sandbox: Experience Platform fornisce sandbox virtuali che suddividono un singolo Platform in ambienti virtuali separati per sviluppare e sviluppare applicazioni di esperienza digitale.

Lettura di chiamate API di esempio

La Policy Service La documentazione API fornisce esempi di chiamate API per dimostrare come formattare le richieste. Questi includono percorsi, intestazioni richieste e payload di richiesta formattati correttamente. Viene inoltre fornito un esempio di codice JSON restituito nelle risposte API. Per informazioni sulle convenzioni utilizzate nella documentazione per le chiamate API di esempio, consulta la sezione sulle come leggere le chiamate API di esempio in Experience Platform guida alla risoluzione dei problemi.

Intestazioni richieste

La documentazione API richiede anche di aver completato la esercitazione sull'autenticazione per effettuare correttamente le chiamate a Platform endpoint. Il completamento dell’esercitazione di 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: {IMS_ORG}

Tutte le risorse in Experience Platform, compresi 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 avrà luogo l’operazione:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

Per ulteriori informazioni sulle sandbox in Platform, vedi documentazione panoramica su sandbox.

Tutte le richieste che contengono un payload (POST, PUT, PATCH) richiedono un’intestazione aggiuntiva:

  • Content-Type: application/json

Core e risorse personalizzate

All'interno di Policy Service API, tutti i criteri e le azioni di marketing sono denominati core o custom risorse.

core le risorse sono quelle definite e gestite dall'Adobe, mentre custom Le risorse sono quelle create e gestite dalla tua organizzazione e sono quindi uniche e visibili solo per la tua organizzazione IMS. Di conseguenza, operazioni di inserimento nell’elenco e ricerca (GET) sono le uniche operazioni consentite su core risorse, mentre operazioni di elenco, ricerca e aggiornamento (POST, PUT, PATCHe DELETE) sono disponibili per custom risorse.

Passaggi successivi

Per iniziare a effettuare chiamate utilizzando l'API di Policy Service, seleziona una delle guide degli endpoint disponibili.

In questa pagina