Panoramica

Puoi creare e gestire segmenti di dati utilizzando l' API Curation Partners, 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 account diservizio per accedere all'API Curation Partners.

  1. Se non l'hai già fatto, crea un progetto Google Cloud Project che ospiti le credenziali utilizzate per accedere all'API.

  2. Vai alla pagina API abilitate della console Google Cloud. Seleziona il progetto che hai creato in precedenza.

  3. Esamina l'elenco delle API e dei servizi abilitati. Per accedere all'API Curation Partners, devi abilitarla. Se l'API Curation Partners non è abilitata, fai clic su +Abilita API e servizi e segui le istruzioni riportate di seguito:

    1. Cerca API Curation Partners utilizzando la casella di ricerca.
    2. Seleziona API Curation Partners nella pagina dei risultati.
    3. Fai clic su Abilita.

    È un problema noto che potresti non essere in grado di trovare l'API Curation Partners con la casella di ricerca della console Google Cloud. In alternativa, puoi utilizzare Google Cloud CLI per abilitare l'API. Dopo aver installato gcloud CLI, puoi abilitare l'API Curation Partners con il seguente comando:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. Nel menu di navigazione, seleziona Credenziali.

  5. Fai clic su +Crea credenziali e nel menu a discesa risultante seleziona Account di servizio.

  6. Inserisci un nome per l'account di servizio. L'ID account di servizio viene creato automaticamente al momento della creazione. Prendi nota di questo valore perché ti servirà in un secondo momento, al passaggio 14. Se vuoi, inserisci una descrizione. Fai clic su Crea e continua.

  7. Se vuoi, configura le autorizzazioni per l'account di servizio e fai clic su Continua.

  8. Se vuoi, configura gli utenti o i gruppi che possono eseguire azioni come account di servizio e fai clic su Fine.

  9. Il nuovo account di servizio è elencato in Account di servizio. Trova e fai clic sull'ID 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 account di servizio con il tuo Technical Account Manager per collegare il service account al tuo account.

Ambiti API

Quando segui 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 Curation Partners, l'ambito è https://www.googleapis.com/auth/curation-partners.

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

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Quando identifichi i segmenti di dati pertinenti per un'opportunità di annunci nella selezione in tempo reale Curation, specifica il valore per l'ID risorsa DATA_SEGMENT_ID anziché il nome risorsa completo fornito dall'API nel campo name.

Passaggi successivi