Creare e modificare segmenti di dati

Creare un nuovo segmento di dati

Puoi creare un nuovo segmento di dati utilizzando il metodo curators.dataSegments.create. Dopo la creazione, il segmento di dati si trova nello stato ACTIVE, consentendo ai deal o ai pacchetti pubblicati tramite le offerte in tempo reale di scegliere come target il segmento di dati.

Per rendere visibili i segmenti di dati ai media planner per il targeting di deal o pacchetti, devi attivare Visibilità segmento nella scheda Impostazioni segmento di dati dell'UI di selezione.

L'esempio seguente esegue una richiesta HTTP POST con un corpo JSON contenente un oggetto DataSegment. La richiesta viene inviata a un endpoint API che crea un segmento di dati con la configurazione specificata.

Esempio di chiamata API curl

Richiesta 

curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"cpmFee":{"nanos":100,"units":0,"currencyCode":"USD"},"name":"curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2"}' \
--compressed

Risposta 

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744379Z",
  "updateTime": "2025-08-14T17:45:08.744379Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 100
  },
  "state": "ACTIVE"
}

Modificare un segmento di dati esistente

Per modificare un segmento di dati esistente, puoi utilizzare il metodo curators.dataSegments.patch. Ad esempio, utilizza questo metodo per modificare il campo cpmFee per il segmento di dati.

L'esempio seguente invia una richiesta HTTP PATCH con un corpo JSON contenente un oggetto DataSegment. La richiesta viene inviata a un endpoint API che modifica il segmento di dati specificato e modifica solo il campo DataSegment.cpmFee.nanos specificato in updateMask.

Esempio di chiamata API curl

Richiesta 

curl --request PATCH \
  'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2?updateMask=cpmFee.nanos&key=[YOUR_API_KEY]' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json'  \
  --data '{"cpmFee":{"nanos":50}}' \
  --compressed

Risposta 

{
  "name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-2",
  "createTime": "2025-08-14T17:45:08.744Z",
  "updateTime": "2025-08-14T17:56:02.200619Z",
  "cpmFee": {
    "currencyCode": "USD",
    "nanos": 50
  },
  "state": "ACTIVE"
}

Passaggi successivi