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 oparty na Twoich danych jest w stanie ACTIVE, co umożliwia kierowanie na niego umów lub pakietów wyświetlanych w ramach określania stawek w czasie rzeczywistym.

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

Poniższy przykład wysyła żą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. Za pomocą tej metody możesz na przykład dostosować cpmFee pole w segmencie danych.

Poniższy przykład wysyła żą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 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