Privacy Service guida per sviluppatori

Adobe Experience Platform Privacy Service fornisce un'API RESTful e un'interfaccia utente che consentono di gestire (accedere ed eliminare) i dati personali degli interessati (clienti) nelle applicazioni Adobe Experience Cloud. Privacy Service fornisce inoltre un meccanismo centrale di controllo e registrazione che consente di accedere allo stato e ai risultati dei processi che coinvolgono Experience Cloud le applicazioni.

Questa guida illustra come utilizzare l' Privacy Service API. Per informazioni dettagliate sull’utilizzo dell’interfaccia utente, consultate la panoramica dell’interfaccia utentePrivacy Service. Per un elenco completo di tutti gli endpoint disponibili nell' Privacy Service API, consultate il riferimento API.

Introduzione

Questa guida richiede una buona conoscenza delle Experience Platform funzioni seguenti:

• Privacy Service: Fornisce un'API RESTful e un'interfaccia utente che consentono di gestire l'accesso e l'eliminazione delle richieste dagli oggetti dati (clienti) tra le applicazioni Adobe Experience Cloud.

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per eseguire correttamente le chiamate all'API Privacy Service.

Lettura di chiamate API di esempio

Questa esercitazione 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.

Raccogli valori per le intestazioni richieste

Per effettuare chiamate all' Privacy Service API, dovete prima raccogliere le credenziali di accesso da utilizzare nelle intestazioni richieste:

• Autorizzazione: Portatore {ACCESS_TOKEN}
• x-api-key: {API_KEY}
• x-gw-ims-org-id: {IMS_ORG}

Ciò comporta il recupero delle autorizzazioni per lo sviluppatore Experience Platform in Adobe Admin Console e la generazione delle credenziali in Adobe Developer Console.

Accesso degli sviluppatori a Experience Platform

Per ottenere l'accesso degli sviluppatori a Platform, segui i passaggi iniziali nell' Experience Platform di esercitazionesull'autenticazione. Una volta raggiunto il passaggio "Generate access Credits in Adobe Developer Console", tornate a questa esercitazione per generare le credenziali specifiche per Privacy Service.

Genera credenziali di accesso

Utilizzando Adobe Developer Console, è necessario generare le seguenti tre credenziali di accesso:

• {IMS_ORG}
• {API_KEY}
• {ACCESS_TOKEN}

È necessario generare {IMS_ORG} e {API_KEY} solo una volta e riutilizzarli in chiamate API future. Tuttavia, {ACCESS_TOKEN} è temporaneo e deve essere rigenerato ogni 24 ore.

Le fasi di generazione di questi valori sono descritte in dettaglio di seguito.

Configurazione una tantum

Andate a console per sviluppatori di Adobi ed effettuate l'accesso con il vostro Adobe ID . Attenetevi quindi ai passaggi descritti nell'esercitazione sulla creazione di un progetto vuoto nella documentazione di Adobe Developer Console.

Dopo aver creato un nuovo progetto, fate clic Add API sulla Project Overview schermata.

Viene Add an API visualizzata la schermata. Seleziona Privacy Service API dall'elenco delle API disponibili prima di fare clic su Next.

Viene Configure API visualizzata la schermata. Selezionate l’opzione da Generate a key pair, quindi fate clic Generate keypair nell’angolo in basso a destra.

La coppia di chiavi viene generata automaticamente e un file ZIP contenente una chiave privata e un certificato pubblico viene scaricato nel computer locale (da utilizzare in un secondo momento). Selezionare Save configured API per completare la configurazione.

Una volta aggiunta l'API al progetto, la pagina del progetto viene nuovamente visualizzata nella pagina di panoramica dell'API Privacy Service. Da qui, scorrete verso il basso fino alla Service Account (JWT) sezione, che fornisce le seguenti credenziali di accesso richieste in tutte le chiamate all' Privacy Service API:

• CLIENT ID: L'ID client è il valore richiesto {API_KEY} per il quale deve essere specificato nell'intestazione x-api-key.
• ORGANIZATION ID: L’ID organizzazione è il {IMS_ORG} valore che deve essere utilizzato nell’intestazione x-gw-ims-org-id.

Autenticazione per ogni sessione

L’ultima credenziale richiesta da raccogliere è quella {ACCESS_TOKEN}utilizzata nell’intestazione Autorizzazione. A differenza dei valori per {API_KEY} e {IMS_ORG}, è necessario generare un nuovo token ogni 24 ore per continuare a utilizzare Platform le API.

Per generare una nuova chiave {ACCESS_TOKEN}, aprite la chiave privata precedentemente scaricata e incollatene il contenuto nella casella di testo accanto a Generate access token prima di fare clic su Generate Token.

Viene generato un nuovo token di accesso e viene fornito un pulsante per copiare il token negli Appunti. Questo valore viene utilizzato per l’intestazione Autorizzazione richiesta e deve essere specificato nel formato Bearer {ACCESS_TOKEN}.

Passaggi successivi

Ora che hai compreso quali intestazioni utilizzare, sei pronto a iniziare a effettuare chiamate all' Privacy Service API. Il documento sui processi di privacy illustra le varie chiamate API che potete effettuare tramite l' Privacy Service API. Ogni chiamata di esempio include il formato API generale, una richiesta di esempio che mostra le intestazioni richieste e una risposta di esempio.