Veri segmentleri oluşturma ve değiştirme

Yeni bir veri segmenti oluşturma

curators.dataSegments.create yöntemini kullanarak yeni bir veri segmenti oluşturabilirsiniz. Oluşturulduktan sonra verilerinize göre segmentiniz ACTIVE durumunda olur. Bu durum, gerçek zamanlı teklif verme özelliğinde yayınlanan anlaşmaların veya paketlerin verilerinize göre segmenti hedeflemesini sağlar.

Veri segmentlerinin anlaşma veya paket hedefleme için medya planlayıcılar tarafından görünür olmasını sağlamak üzere Seçim kullanıcı arayüzünün Veri segmenti ayarları sekmesinde Segment görünürlüğü'nü etkinleştirmeniz gerekir.

Aşağıdaki örnekte, POST nesnesi içeren bir JSON içeriğiyle HTTP POST isteği gönderilmektedir.DataSegment İstek, belirtilen yapılandırmaya sahip bir veri segmenti oluşturan bir API uç noktasına gönderilir.

Örnek curl API çağrısı

İstek 

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

Yanıt 

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

Mevcut bir veri segmentini değiştirme

Mevcut bir veri segmentini değiştirmek için curators.dataSegments.patch yöntemini kullanabilirsiniz. Örneğin, veri segmenti için cpmFee alanını ayarlamak üzere bu yöntemi kullanın.

Aşağıdaki örnekte, PATCH nesnesi içeren bir JSON gövdesiyle HTTP PATCH isteği gönderilmektedir.DataSegment İstek, belirtilen veri segmentini değiştiren bir API uç noktasına gönderilir ve yalnızca DataSegment.cpmFee.nanos alanı updateMask içinde belirtilen şekilde değiştirilir.

Örnek curl API çağrısı

İstek 

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

Yanıt 

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

Sonraki adımlar