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

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

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

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

مثال زیر یک درخواست HTTP POST با بدنه JSON حاوی یک شی DataSegment ایجاد می کند. درخواست به یک نقطه پایانی API ارسال می شود که یک بخش داده با پیکربندی مشخص شده ایجاد می کند.

نمونه تماس curl API

درخواست کنید 

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 را تغییر می دهد.

نمونه تماس curl API

درخواست کنید 

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

مراحل بعدی