יצירה ושינוי של פלחי נתונים

יצירת פלח נתונים חדש

אפשר ליצור פלח נתונים חדש באמצעות השיטה curators.dataSegments.create אחרי היצירה, פלח הנתונים נמצא במצב ACTIVE, כך שאפשר לטרגט את פלח הנתונים באמצעות חבילות או עסקאות שמוצגות בבידינג בזמן אמת.

כדי שמתכנני מדיה יוכלו לראות את פלחי הנתונים לצורך טירגוט של חבילות או עסקאות, צריך להפעיל את האפשרות חשיפת פלחים בכרטיסייה הגדרות פלחי נתונים בממשק המשתמש של מרכז בקרת התוכן.

בדוגמה הבאה מוצגת בקשת HTTP POST עם גוף JSON שמכיל אובייקט DataSegment. הבקשה נשלחת לנקודת קצה של API שיוצרת פלח נתונים עם ההגדרה שצוינה.

דוגמה לקריאה ל-API באמצעות curl

בקשה

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

תשובה

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

שינוי של פילוח נתונים קיים

כדי לשנות פלח נתונים קיים, אפשר להשתמש בשיטה curators.dataSegments.patch. לדוגמה, אפשר להשתמש בשיטה הזו כדי לשנות את השדה cpmFee של פלח הנתונים.

בדוגמה הבאה מוצגת בקשת HTTP PATCH עם גוף JSON שמכיל אובייקט DataSegment. הבקשה נשלחת לנקודת קצה ב-API שמשנה את פלח הנתונים שצוין, ומשנה רק את השדה DataSegment.cpmFee.nanos שצוין ב-updateMask.

דוגמה לקריאה ל-API באמצעות curl

בקשה

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

תשובה

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

השלבים הבאים