بخش های داده را ایجاد و اصلاح کنید

ایجاد یک بخش داده جدید

شما می‌توانید با استفاده از متد curators.dataSegments.create یک بخش داده جدید ایجاد کنید. پس از ایجاد، بخش داده شما در حالت ACTIVE قرار می‌گیرد و معاملات یا بسته‌هایی که در مناقصه‌های بلادرنگ ارائه می‌شوند را قادر می‌سازد تا بخش داده را هدف قرار دهند.

برای اینکه بخش‌های داده برای برنامه‌ریزان رسانه‌ای جهت هدف‌گذاری معامله یا بسته قابل مشاهده باشند، باید قابلیت Segment visibility را در تب تنظیمات بخش داده در رابط کاربری Curation فعال کنید.

مثال زیر یک درخواست 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"
}

مراحل بعدی