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

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

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

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

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

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

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

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

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