Reporting API: تقرير نشاط الرموز المميّزة للتفويض

يعرض تقرير نشاط الرمز المميّز للتفويض معلومات عن الجهة الخارجية. مواقع الويب والتطبيقات التي منحها المستخدمون إمكانية الوصول إليها. كل تقرير طلب نقطة نهاية التقرير الأساسي مع المعلمات الخاصة بالتقرير مثل كنطاق الجهة الخارجية أو نطاقات التفويض التي تم منحها. الحد الأقصى للوقت لكل تقرير هو آخر 180 يومًا.

لا يمكن استخدام تقرير نشاط رمز OAuth المميز إلا لأغراض قانونية وفقًا لاتفاقية العملاء.

استرداد جميع أحداث الرموز المميّزة للتفويض لنطاق معيّن

لاسترداد جميع أحداث التفويض للتطبيقات التابعة للجهات الخارجية، استخدِم ملف اتباع طلب HTTP GET وتضمين الرمز المميز للتفويض الموضح في مستندات التفويض لمزيد من المعلومات حول سلاسل طلب البحث وخصائص الاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات. لأغراض تسهيل القراءة، يتم تنسيق المثال التالي باستخدام أسطر أسطر:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

يحصل المثال التالي على تقرير عن جميع أحداث التفويض في حسابك. خلال آخر 180 يومًا تحتوي معلمة طلب البحث maxResults على إرجاع التقرير هذا 25 نتيجة في الصفحة.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25

استرداد أحداث الرمز المميّز للتفويض حسب اسم الحدث

وفي بعض الحالات، قد ترغب في استرداد أحداث معينة، مثل ما إذا كان تم إبطال إمكانية وصول التطبيق. لإجراء ذلك، يمكنك استخدام طلب HTTP يتضمّن GET. بالصيغة التالية:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?maxResults=maximum number of events returned on a response page
&eventName=name of the OAuth token event

يوضّح المثال التالي كيفية استرداد جميع أحداث revoke لنطاق معيّن:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25