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 berada dalam status ACTIVE, sehingga memungkinkan penawaran atau paket yang ditayangkan dalam Bidding Real-Time menargetkan segmen data tersebut.

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

Contoh berikut membuat permintaan HTTP POST 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 kolom cpmFee untuk segmen data.

Contoh berikut membuat permintaan HTTP PATCH 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