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

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

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

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