تفعيل شريحة جمهور مستندة إلى بيانات
لتفعيل إحدى شرائح البيانات، استخدِم طريقة 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.
- مزيد من المعلومات عن مواصفات "التنظيم في الوقت الفعلي"
- تعرَّف على كيفية تحليل طلبات المقاطع الواردة في "اختيار المحتوى في الوقت الفعلي".