واجهة برمجة التطبيقات لإعداد التقارير: تقرير نشاط الرموز المميزة للتفويض

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