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 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 na potrzeby kierowania ofert lub pakietów, musisz włączyć 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 o określonej konfiguracji.

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