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 veri segmentiniz ACTIVE durumunda olur. Bu durum, gerçek zamanlı teklif verme kapsamında yayınlanan anlaşmaların veya paketlerin veri segmentini hedeflemesini sağlar.

Veri segmentlerinin anlaşma veya paket hedefleme için medya planlayıcılar tarafından görünür olması için Seçme 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 gövdesiyle 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 updateMask içinde belirtilen DataSegment.cpmFee.nanos alanı 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