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. Una volta creato, il segmento di dati si trova nello stato ACTIVE, consentendo ai deal o ai pacchetti pubblicati in Real Time Bidding 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 l'opzione Visibilità segmento nella scheda Impostazioni segmento di dati dell'interfaccia utente 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 esegue 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