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