Segmente mit selbst erhobenen Daten erstellen und ändern

Neues Datensegment erstellen

Sie können ein neues Datensegment mit der Methode curators.dataSegments.create erstellen. Nach der Erstellung befindet sich Ihr Datensegment im Status ACTIVE. So können Deals oder Pakete, die im Real-Time Bidding 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 Datensegmenteinstellungen der Kuratierungs-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 der 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