إنشاء شرائح الجمهور المستندة إلى بيانات المستخدِمين وتعديلها

إنشاء شريحة جمهور جديدة مستندة إلى البيانات

يمكنك إنشاء شريحة بيانات جديدة باستخدام طريقة curators.dataSegments.create. بعد إنشاء شريحة البيانات، ستكون في الحالة ACTIVE، ما يتيح الصفقات أو الحِزم التي يتم عرضها في "عروض الأسعار في الوقت الفعلي" استهداف شريحة البيانات.

لإتاحة شرائح الجمهور المستندة إلى البيانات لخبراء تخطيط وسائل الإعلام من أجل استهداف الصفقات أو الحِزم، عليك تفعيل إمكانية رؤية شرائح الجمهور في علامة التبويب إعدادات شرائح الجمهور المستندة إلى البيانات ضمن واجهة مستخدم التنسيق.

يرسل المثال التالي طلب HTTP POST مع نص JSON يحتوي على عنصر DataSegment. يتم إرسال الطلب إلى نقطة نهاية واجهة برمجة تطبيقات تنشئ شريحة بيانات باستخدام الإعدادات المحدّدة.

مثال على طلب بيانات من واجهة برمجة التطبيقات باستخدام 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. يتم إرسال الطلب إلى نقطة نهاية في واجهة برمجة التطبيقات تعدّل جزء البيانات المحدّد، ولا تعدّل سوى الحقل DataSegment.cpmFee.nanos المحدّد في updateMask.

مثال على طلب بيانات من واجهة برمجة التطبيقات باستخدام 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"
}

الخطوات التالية