با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
گزارش فعالیت نشانه مجوز، اطلاعات مربوط به وب‌سایت‌ها و برنامه‌های شخص ثالث و برنامه‌هایی را که کاربران شما به آنها اجازه دسترسی داده‌اند، برمی‌گرداند. هر گزارش از درخواست نقطه پایانی گزارش اولیه با پارامترهای گزارش خاص مانند دامنه شخص ثالث یا محدوده مجوز اعطا شده استفاده می کند. حداکثر دوره زمانی برای هر گزارش 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
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Reports API: Authorization Tokens Activity Report\n\nThe authorization token activity report returns information about third party\nwebsites and applications your users have granted access for. Each report\nuses the basic report endpoint request with report-specific parameters such\nas the third party domain or authorization scopes granted. The maximum time\nperiod for each report is the last 180 days.\n\nThe OAuth token activity report may be used only for lawful purposes in accordance with your Customer Agreement.\n\nRetrieve all authorization token events for a domain\n----------------------------------------------------\n\nTo retrieve all authorization events for third party applications, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](https://developers.google.com/workspace/admin/reports/v1/guides/authorizing.html).\nFor more information about the request query strings and response properties,\nsee the [API Reference](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/token-event-names).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's authorization events\nfor the past 180 days. The `maxResults` query parameter has this report return\n25 results per page. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25\n```\n\nRetrieve authorization token events by event name\n-------------------------------------------------\n\nIn some instances, you may want to retrieve specific events, such as whether an\napplication's access has been revoked. To do this, use a `GET` HTTP request\nof the following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?maxResults=maximum number of events returned on a response page\n&eventName=name of the OAuth token event\n```\n\nThe following example shows how to retrieve all `revoke` events for a domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25\n```"]]
