Segmente mit selbst erhobenen Daten erstellen und ändern

Neues Datensegment erstellen

Mit der Methode curators.dataSegments.create können Sie ein neues Datensegment erstellen. Nach der Erstellung befindet sich Ihr Datensegment im Status ACTIVE. So können Deals oder Pakete, die im Echtzeitgebot ausgeliefert werden, auf das Datensegment ausgerichtet werden.

Damit Datensegmente für Media-Planer für das Targeting von Deals oder Paketen sichtbar sind, müssen Sie auf dem Tab Datensegment-Einstellungen der Curation UI die Option Sichtbarkeit von Segmenten aktivieren.

Im folgenden Beispiel wird eine HTTP-POST-Anfrage mit einem JSON-Body gesendet, der ein DataSegment-Objekt enthält. Die Anfrage wird an einen API-Endpunkt gesendet, der ein Datensegment mit der angegebenen Konfiguration erstellt.

Beispiel für einen curl API-Aufruf

Anfrage

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

Antwort

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

Vorhandenes Segment mit selbst erhobenen Daten ändern

Wenn Sie ein vorhandenes Datensegment ändern möchten, können Sie die Methode curators.dataSegments.patch verwenden. Verwenden Sie diese Methode beispielsweise, um das Feld cpmFee für das Datensegment anzupassen.

Im folgenden Beispiel wird eine HTTP-PATCH-Anfrage mit einem JSON-Body gesendet, der ein DataSegment-Objekt enthält. Die Anfrage wird an einen API-Endpunkt gesendet, der das angegebene Datensegment ändert. Dabei wird nur das Feld DataSegment.cpmFee.nanos geändert, das in updateMask angegeben ist.

Beispiel für einen curl API-Aufruf

Anfrage

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

Antwort

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

Nächste Schritte