Créer et modifier des segments de données

Créer un segment de données

Vous pouvez créer un segment de données à l'aide de la méthode curators.dataSegments.create. Une fois votre segment de données créé, il est à l'état ACTIVE. Les accords ou les packages diffusés dans les enchères en temps réel peuvent alors cibler ce segment de données.

Pour que les planificateurs média puissent voir les segments de données pour le ciblage des offres ou des packages, vous devez activer l'option Visibilité des segments dans l'onglet Paramètres des segments de données de l'interface utilisateur de curation.

L'exemple suivant effectue une requête HTTP POST avec un corps JSON contenant un objet DataSegment. La requête est envoyée à un point de terminaison d'API qui crée un segment de données avec la configuration spécifiée.

Exemple d'appel d'API curl

Requête

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

Réponse

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

Modifier un segment de données existant

Pour modifier un segment de données existant, vous pouvez utiliser la méthode curators.dataSegments.patch. Par exemple, utilisez cette méthode pour ajuster le champ cpmFee du segment de données.

L'exemple suivant effectue une requête HTTP PATCH avec un corps JSON contenant un objet DataSegment. La requête est envoyée à un point de terminaison d'API qui modifie le segment de données spécifié et ne modifie que le champ DataSegment.cpmFee.nanos spécifié dans updateMask.

Exemple d'appel d'API curl

Requête

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

Réponse

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

Étapes suivantes