Membuat dan mengubah segmen data

Membuat segmen data baru

Anda dapat membuat segmen data baru menggunakan metode curators.dataSegments.create. Setelah dibuat, segmen data Anda akan berada dalam status ACTIVE, sehingga memungkinkan kesepakatan atau paket yang ditayangkan di Real-time Bidding untuk menargetkan segmen data.

Agar segmen data dapat dilihat oleh perencana media untuk penargetan kesepakatan atau paket, Anda harus mengaktifkan Visibilitas segmen di tab Setelan segmen data pada UI Kurasi.

Contoh berikut membuat permintaan POST HTTP dengan isi JSON yang berisi objek DataSegment. Permintaan dikirim ke endpoint API yang membuat segmen data dengan konfigurasi yang ditentukan.

Contoh panggilan API curl

Permintaan 

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

Respons 

{
  "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"
}

Mengubah segmen data yang ada

Untuk mengubah segmen data yang ada, Anda dapat menggunakan metode curators.dataSegments.patch. Misalnya, gunakan metode ini untuk menyesuaikan cpmFee kolom untuk segmen data.

Contoh berikut membuat permintaan PATCH HTTP dengan isi JSON yang berisi objek DataSegment. Permintaan dikirim ke endpoint API yang mengubah segmen data yang ditentukan, dan hanya mengubah kolom DataSegment.cpmFee.nanos yang ditentukan dalam updateMask.

Contoh panggilan API curl

Permintaan 

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

Respons 

{
  "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"
}

Langkah berikutnya