گزارش فعالیت نشانه مجوز، اطلاعات مربوط به وب‌سایت‌ها و برنامه‌های شخص ثالث و برنامه‌هایی را که کاربران شما به آنها اجازه دسترسی داده‌اند، برمی‌گرداند. هر گزارش از درخواست نقطه پایانی گزارش اولیه با پارامترهای گزارش خاص مانند دامنه شخص ثالث یا محدوده مجوز اعطا شده استفاده می کند. حداکثر دوره زمانی برای هر گزارش 180 روز گذشته است.
گزارش فعالیت نشانه OAuth ممکن است فقط برای اهداف قانونی مطابق با توافق نامه مشتری شما استفاده شود.
بازیابی همه رویدادهای نشانه مجوز برای یک دامنه
برای بازیابی همه رویدادهای مجوز برای برنامه های شخص ثالث، از درخواست GET HTTP زیر استفاده کنید و کد مجوز شرح داده شده در اسناد مجوز را اضافه کنید. برای اطلاعات بیشتر در مورد رشته های درخواست درخواست و ویژگی های پاسخ، به مرجع API مراجعه کنید. برای اهداف خوانایی، مثال زیر با برگرداندن خط قالب بندی شده است:
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 روز گذشته دریافت می کند. پارامتر query 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