Panoramica

Puoi creare e gestire segmenti di dati utilizzando l'API Authorized Buyers Marketplace, che espone una risorsa curators.dataSegments. Si tratta di un'API REST con librerie client generate che puoi utilizzare per l'integrazione.

Configura l'autenticazione

Le API di Google utilizzano il protocollo OAuth 2.0 per l'autenticazione e l'autorizzazione. Ecco come configurare un service account per accedere all'API Marketplace.

  1. Se non l'hai ancora fatto, crea un progetto Google Cloud che ospita le credenziali utilizzate per accedere all'API.
  2. Vai alla pagina API abilitate di Google Cloud Console. Seleziona il progetto che hai creato in precedenza.

  3. Viene visualizzato un elenco di API e servizi abilitati. Per accedere all'API Marketplace, devi abilitarla. Se l'API Marketplace non è abilitata, fai clic su + Abilita API e servizi e segui le istruzioni riportate di seguito:

    1. Viene visualizzata una pagina con una casella di ricerca. Cerca API Authorized Buyers Marketplace.
    2. Seleziona API Authorized Buyers Marketplace nella pagina dei risultati.
    3. Fai clic su Abilita.
  4. Nel menu di navigazione, seleziona Credenziali.
  5. Fai clic su +Crea credenziali e seleziona Account di servizio nel menu a discesa visualizzato.
  6. Inserisci un Nome per il service account. L'ID service account viene creato automaticamente al momento della creazione. Prendi nota di questo valore perché ti servirà in un secondo momento nel passaggio 14. Se vuoi, inserisci una descrizione. Fai clic su Crea e continua.
  7. (Facoltativo) Configura le autorizzazioni per l'account di servizio e fai clic su Continua.
  8. (Facoltativo) Configura gli utenti o i gruppi che possono eseguire azioni come service account e fai clic su Fine.
  9. Il nuovo service account è elencato in Service account. Trova e fai clic sull'ID dell'account di servizio che hai appena creato.
  10. Fai clic sulla scheda Chiavi.
  11. Nel menu a discesa Aggiungi chiave, seleziona Crea nuova chiave.
  12. Seleziona JSON come Tipo di chiave e fai clic su Crea.
  13. Scarica la chiave nella directory di lavoro. Per saperne di più su come archiviare la chiave in modo sicuro, consulta la sezione Gestire le chiavi degli account di servizio. La chiave viene utilizzata dall'applicazione per effettuare chiamate API.
  14. Condividi l'ID service account con il tuo Technical Account Manager per collegare il service account al tuo account.

Ambiti API

Quando esegui il flusso OAuth 2.0 per ricevere un token di accesso utilizzato per effettuare una chiamata API, devi specificare le API a cui è possibile accedere utilizzando quel token. Per l'API Marketplace di Authorized Buyers, l'ambito è https://www.googleapis.com/auth/authorized-buyers-marketplace.

Come identificare i segmenti di dati nell'API rispetto alla gestione in tempo reale

Nell'API Marketplace, i segmenti di dati vengono identificati con un nome di risorsa specifico dell'API, ad esempio:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Quando identifichi i segmenti di dati pertinenti per un'opportunità pubblicitaria nella selezione in tempo reale, specifica il valore per l'ID risorsa DATA_SEGMENT_ID anziché la risorsa completa name utilizzata dall'API.

Passaggi successivi