Создание и изменение сегментов данных

Создайте новый сегмент данных.

Вы можете создать новый сегмент данных, используя метод curators.dataSegments.create . После создания ваш сегмент данных переходит в состояние ACTIVE , что позволяет сделкам или пакетам, используемым в торгах в реальном времени, ориентироваться на этот сегмент данных.

Чтобы сделать сегменты данных видимыми для медиапланеров при таргетировании сделок или пакетов, необходимо включить видимость сегментов на вкладке « Настройки сегментов данных» в пользовательском интерфейсе управления контентом .

В следующем примере выполняется HTTP POST запрос с телом в формате JSON, содержащим объект DataSegment . Запрос отправляется на конечную точку API, которая создает сегмент данных с указанной конфигурацией.

Пример вызова API curl

Запрос 

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

Ответ 

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

Изменить существующий сегмент данных

Для изменения существующего сегмента данных можно использовать метод curators.dataSegments.patch . Например, используйте этот метод для корректировки поля cpmFee для сегмента данных.

В следующем примере выполняется HTTP-запрос PATCH с телом в формате JSON, содержащим объект DataSegment . Запрос отправляется на конечную точку API, которая изменяет указанный сегмент данных и затрагивает только поле DataSegment.cpmFee.nanos указанное в параметре updateMask .

Пример вызова API curl

Запрос 

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

Ответ 

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

Следующие шаги