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

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

אפשר ליצור פלח נתונים חדש באמצעות השיטה 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"
}

השלבים הבאים