دليل سريع لتنفيذ واجهة برمجة التطبيقات واختبارها يمكنك الوصول إلى المواضيع باستخدام JavaScript ومشاركة ملاحظاتك.
تعرَّف على الأساسيات
- تقدّم نظرة عامة على Topics API واجهة برمجة التطبيقات وتوضّح المشاكل التي تعالجها.
- يوضّح تصنيف المواضيع نموذج المصنِّف، وكيفية استنتاج المواضيع وتخصيصها لمتصفّحات المستخدمين، وكيفية تحكّم المستخدمين في قائمة مواضيعهم.
- يتناول دليل مطوّري Topics API عملية الإعداد والحصول على المواضيع وإعدادها باستخدام JavaScript والعناوين وتصحيح الأخطاء.
تجربة واجهة برمجة التطبيقات
- يمكنك الاطّلاع على صفحة حالة "مبادرة حماية الخصوصية" للاطّلاع على آخر الأخبار عن حالة تنفيذ Topics API.
- جرِّب استخدام واجهة برمجة التطبيقات:
- يمكنك تجربة المواضيع لمستخدم واحد في الإصدار 101 من Chrome أو الإصدارات الأحدث من خلال تفعيل
chrome://flags/#privacy-sandbox-ads-apis
أو تشغيل Chrome من سطر الأوامر باستخدام--enable-features=PrivacySandboxAdsAPIsOverride
علامة الميزة. يُرجى الاطّلاع على الإصدارات التجريبية من Topics API. - يوضّح دليل المطوِّرين لواجهة Topics API كيفية استخدام Topics JavaScript API أو أسلوب العنوان (الجلب أو إطار iframe) للوصول إلى المواضيع التي تتم ملاحظتها للمستخدم الحالي.
- يمكنك تجربة المواضيع لمستخدم واحد في الإصدار 101 من Chrome أو الإصدارات الأحدث من خلال تفعيل
الحصول على الدعم
هل هناك ما يمنعك من تجربة واجهة برمجة التطبيقات؟ اطرح سؤالاً عن عملية التنفيذ أو عن المستندات:
- افتح مشكلة جديدة في مستودع دعم مطوّري برامج "مبادرة حماية الخصوصية". تأكَّد من اختيار نموذج المشكلة في "المواضيع".
- للاطّلاع على مزيد من الأسئلة العامة حول كيفية تلبية حالات الاستخدام لواجهة برمجة التطبيقات، يمكنك الإبلاغ عن مشكلة في مستودع واجهة برمجة التطبيقات.
بالنسبة إلى الأخطاء والمشاكل المتعلقة بتنفيذ Topics API في Chrome:
- الاطّلاع على المشاكل الحالية التي تم الإبلاغ عنها في واجهة برمجة التطبيقات
- يمكنك طرح مشكلة جديدة على crbug.com/new.
الانضمام إلى المناقشة
نرحّب بالجميع للمشاركة في نقاش حول Topics API. وعلى وجه الخصوص، إذا كنت تجرّب واجهة برمجة التطبيقات، فإن ملاحظاتك ضرورية.
مناقشة واجهة برمجة التطبيقات
مثل واجهات برمجة تطبيقات "مبادرة حماية الخصوصية" الأخرى، يتم توثيق واجهة برمجة التطبيقات هذه ومناقشتها بشكل علني.
- يمكنك قراءة الشرح على GitHub.
- انضم إلى المحادثة حول المشاكل الحالية.
- افتح مشكلة جديدة لطرح سؤال أو اقتراح ميزة أو مناقشة حالة استخدام.
مناقشة مواضيع ذات صلة
- ناقش حالات الاستخدام في المجال من خلال تحسين مجموعة الأنشطة التجارية للإعلانات على الويب.
تقديم التعليقات
- استخدِم نموذج الملاحظات في "مبادرة حماية الخصوصية" لمشاركة الملاحظات بشكل خاص مع فريق Chrome خارج المنتديات العامة.
- توضّح ملاحظات حول "مبادرة حماية الخصوصية" كيفية تقديم أنواع أخرى من الملاحظات وكيفية المشاركة في مناقشة حول واجهات برمجة تطبيقات "مبادرة حماية الخصوصية".
البقاء على اطّلاع
- لتلقّي إشعارات بشأن تغييرات الحالة في واجهة برمجة التطبيقات، عليك الانضمام إلى القائمة البريدية لمطوّري البرامج.
- لمتابعة جميع المناقشات الجارية حول واجهة برمجة التطبيقات عن كثب، انقر على الزر مشاهدة في صفحة GitHub على GitHub. ويتطلب هذا أن يكون لديك أو إنشاء حساب GitHub.
- للحصول على آخر الأخبار العامة حول "مبادرة حماية الخصوصية"، يمكنك الاشتراك في خلاصة RSS [Progress in the Privacy Sandbox].