Segmente mit selbst erhobenen Daten erstellen und ändern

Neues Segment mit selbst erhobenen Daten erstellen

Sie können mit der Methode „ curators.dataSegments.create “ ein neues Segment mit selbst erhobenen Daten erstellen. Nach der Erstellung hat das Segment den Status ACTIVE. Dadurch können Deals oder Pakete, die in Echtzeitgeboten ausgeliefert werden, auf das Segment ausgerichtet werden.

Damit Segmente mit selbst erhobenen Daten für Media-Planer für das Targeting von Deals oder Paketen sichtbar sind, müssen Sie auf dem Tab Einstellungen für Segmente mit selbst erhobenen Daten der Curation UI die Option Segment-Sichtbarkeit aktivieren.

Im folgenden Beispiel wird eine HTTP-POST-Anfrage mit einem JSON-Text gesendet, der ein DataSegment-Objekt enthält. Die Anfrage wird an einen API-Endpunkt gesendet, der ein Segment mit selbst erhobenen Daten 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 Segment mit selbst erhobenen Daten ändern möchten, können Sie die curators.dataSegments.patch verwenden. Mit dieser Methode können Sie beispielsweise das cpmFee Feld für das Segment anpassen.

Im folgenden Beispiel wird eine HTTP-PATCH-Anfrage mit einem JSON-Text gesendet, der ein DataSegment-Objekt enthält. Die Anfrage wird an einen API-Endpunkt gesendet, der das angegebene Segment ä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