تفعيل شريحة جمهور مستندة إلى بيانات
لتفعيل إحدى شرائح البيانات، استخدِم طريقة curators.dataSegments.activate. يمكن للمشترين استهداف شرائح البيانات في الصفقات أو الحِزم.
يقدم المثال التالي طلب HTTP POST إلى نقطة نهاية واجهة برمجة تطبيقات تعمل على تفعيل شريحة بيانات محددة.
مثال على طلب بيانات من واجهة برمجة التطبيقات باستخدام curl
طلب
curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1:activate?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed
الردّ
{
"name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1",
"createTime": "2025-08-13T12:14:03.421Z",,
"updateTime": "2025-08-14T19:47:40.253938Z",
"cpmFee": {
"currencyCode": "USD",
"units": "1000000"
},
"state": "ACTIVE"
}
إيقاف شريحة جمهور مستندة إلى بيانات
لإيقاف إحدى شرائح البيانات، استخدِم طريقة curators.dataSegments.deactivate.
يقدم المثال التالي طلب HTTP POST إلى نقطة نهاية واجهة برمجة تطبيقات تعمل على إيقاف شريحة بيانات محددة.
مثال على طلب بيانات من واجهة برمجة التطبيقات باستخدام curl
طلب
curl --request POST \
'https://authorizedbuyersmarketplace.googleapis.com/v1beta/curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1:deactivate?key=[YOUR_API_KEY]' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{}' \
--compressed
الردّ
{
"name": "curators/[YOUR_ACCOUNT_ID]/dataSegments/test-data-segment-1",
"createTime": "2025-08-13T12:14:03.421Z",
"updateTime": "2025-08-14T20:05:51.439110Z",
"cpmFee": {
"currencyCode": "USD",
"units": "1000000"
},
"state": "INACTIVE"
}
الخطوات التالية
- تعرَّف على كيفية عرض شرائح بياناتك باستخدام Marketplace API.
- مزيد من المعلومات عن مواصفات Real-time Curation
- كيفية تحليل طلبات الأقسام الواردة في "اختيار المحتوى في الوقت الفعلي"