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

إنشاء شريحة بيانات جديدة

يمكنك إنشاء شريحة بيانات جديدة باستخدام طريقة 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 لشريحة البيانات.

يرسل المثال التالي طلب PATCH HTTP مع نص 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"
}

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