Tworzenie i modyfikowanie segmentów danych

Tworzenie nowego segmentu danych

Nowy segment danych możesz utworzyć za pomocą metody curators.dataSegments.create. Po utworzeniu segment danych ma stan ACTIVE, co umożliwia umowom lub pakietom wyświetlanym w ramach określania stawek w czasie rzeczywistym kierowanie na ten segment.

Aby segmenty danych były widoczne dla planistów mediów na potrzeby kierowania na transakcje lub pakiety, musisz włączyć opcję Widoczność segmentu na karcie Ustawienia segmentu danych w interfejsie wyboru.

W tym przykładzie wysyłamy żądanie HTTP POST z treścią JSON zawierającą obiekt DataSegment. Żądanie jest wysyłane do punktu końcowego interfejsu API, który tworzy segment danych z określoną konfiguracją.

Przykładowe wywołanie interfejsu API za pomocą polecenia curl

Żądanie

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

Odpowiedź

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

Modyfikowanie istniejącego segmentu danych

Aby zmodyfikować istniejący segment danych, możesz użyć metody curators.dataSegments.patch. Możesz na przykład użyć tej metody, aby dostosować pole cpmFee w przypadku segmentu danych.

W tym przykładzie wysyłamy żądanie HTTP PATCH z treścią JSON zawierającą obiekt DataSegment. Żądanie jest wysyłane do punktu końcowego interfejsu API, który modyfikuje określony segment danych i zmienia tylko pole DataSegment.cpmFee.nanos określone w updateMask.

Przykładowe wywołanie interfejsu API za pomocą polecenia curl

Żądanie

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

Odpowiedź

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

Dalsze kroki