Criar e modificar segmentos de dados

Criar um novo segmento de dados

É possível criar um segmento de dados usando o método curators.dataSegments.create. Depois da criação, seu segmento de dados fica no estado ACTIVE, permitindo que transações ou pacotes veiculados em lances em tempo real segmentem o segmento de dados.

Para tornar os segmentos de dados visíveis aos planejadores de mídia para segmentação de pacotes ou ofertas, ative a Visibilidade do segmento na guia Configurações do segmento de dados da interface de seleção.

O exemplo a seguir faz uma solicitação HTTP POST com um corpo JSON que contém um objeto DataSegment. A solicitação é enviada a um endpoint de API que cria um segmento de dados com a configuração especificada.

Exemplo de chamada da API curl

Solicitação 

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

Resposta 

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

Modificar um segmento de dados

Para modificar um segmento de dados, use o método curators.dataSegments.patch. Por exemplo, use esse método para ajustar o campo cpmFee do segmento de dados.

O exemplo a seguir faz uma solicitação HTTP PATCH com um corpo JSON que contém um objeto DataSegment. A solicitação é enviada a um endpoint da API que modifica o segmento de dados especificado e apenas o campo DataSegment.cpmFee.nanos especificado no updateMask.

Exemplo de chamada da API curl

Solicitação 

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

Resposta 

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

Próximas etapas