Cómo crear y modificar segmentos basados en tus datos

Crea un segmento de datos nuevo

Puedes crear un segmento de datos nuevo con el método curators.dataSegments.create. Después de la creación, tu segmento de datos estará en el estado ACTIVE, lo que permitirá que las ofertas o los paquetes que se publican en la segmentación en tiempo real se segmenten para el segmento de datos.

Para que los segmentos de datos sean visibles para los planificadores de medios en la segmentación de acuerdos o paquetes, debes habilitar la opción Visibilidad del segmento en la pestaña Configuración del segmento de datos de la IU de Curación.

En el siguiente ejemplo, se realiza una solicitud HTTP POST con un cuerpo JSON que contiene un objeto DataSegment. La solicitud se envía a un extremo de API que crea un segmento de datos con la configuración especificada.

Ejemplo de llamada a la API de curl

Solicitud

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

Respuesta

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

Cómo modificar un segmento de datos existente

Para modificar un segmento de datos existente, puedes usar el método curators.dataSegments.patch. Por ejemplo, usa este método para ajustar el campo cpmFee del segmento de datos.

En el siguiente ejemplo, se realiza una solicitud HTTP PATCH con un cuerpo JSON que contiene un objeto DataSegment. La solicitud se envía a un extremo de API que modifica el segmento de datos especificado y solo modifica el campo DataSegment.cpmFee.nanos especificado en updateMask.

Ejemplo de llamada a la API de curl

Solicitud

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

Respuesta

{
  "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óximos pasos