סקירה כללית על Reports API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Reports API הוא API מסוג RESTful שאפשר להשתמש בו כדי לגשת למידע על הפעילויות של המשתמשים ב-Google Workspace. Reports API הוא חלק מ-Admin SDK API.
ב-Reports API יש שני סוגי דוחות:
- דוחות פעילות, שכוללים אירועים של אפליקציה או שירות ספציפיים, כמו Google Drive או מסוף Admin.
- דוחות שימוש, שכוללים רשימה של אירועים ב-Workspace שנגרמו על ידי משתמשים.
- בדוחות השימוש של הלקוח מפורטים אירועים של כל המשתמשים בדומיין.
- בדוחות השימוש במשתמשים מופיעים אירועים שמסודרים לפי משתמש.
ריכזנו כאן רשימה של מונחים נפוצים שמשמשים ב-Reports API:
- דוחות פעילות
בדוחות הפעילות מפורט מידע על פעילויות באפליקציה או בשירות ספציפיים של Google Workspace. דוחות הפעילות כוללים את התאריך, השעה, המשתמש וסוג הפעילות. הפניית ה-API כוללת רשימה מלאה של דוחות פעילות והמידע שכלול בהם.
ריכזנו כאן כמה דוגמאות לדוחות פעילות, לפי אפליקציה או שירות:
- דוחות פעילות של אדמינים
מציגים פעילויות שבוצעו על ידי אדמינים באמצעות מסוף Admin. לדוגמה, אפשר לקבל רשימה של כל הפעמים שבהן אדמינים שינו את השם של משתמש באמצעות מסוף Admin.
- דוחות פעילות ב-Google Drive
מציגים רשימה של פעולות העריכה והצפייה במסמכים ב-Drive שבוצעו על ידי המשתמשים בדומיין. לדוגמה, אפשר לקבל רשימה של הפעילות של משתמש מסוים ב-Drive.
- דוחות על פעילות התחברות מספקים מידע על מועדי הכניסה והיציאה של המשתמשים בחשבון שלהם. לדוגמה, אפשר לקבל דוח על כל הכניסות לדומיין שלכם במהלך תקופת זמן מסוימת.
- דוחות על פעילות במכשירים ניידים
מציגים פעילויות שבוצעו באמצעות מכשירים ניידים שמנוהלים על ידי
הניהול של Google למכשירים ניידים.
לדוגמה, אתם יכולים לקבל התראה כשמשתמשים רושמים מכשיר חדש.
- דוחות על פעילות של אסימוני OAuth
מפרטים אירועים שקורים כשמשתמשים מעניקים או מבטלים אסימוני הרשאה שמשמשים
אתרים ואפליקציות של צד שלישי. אתם יכולים להשתמש ב-Reports API כדי לקבל רשימה של כל הגישות של צד שלישי לנתונים של משתמש ב-Google Workspace.
- דוחות שימוש
דוחות השימוש מספקים מידע על אירועים ב-Google Workspace בדומיין שלכם.
אפשר להשתמש ב-API כדי לבקש מידע ספציפי על משתמשים.
- דוחות השימוש של הלקוחות מציגים רשימה של פעילויות מפורטות באפליקציות ובשירותים בחשבון שלכם. המידע הזה על השימוש מסודר לפי סוג האפליקציה ומכיל מידע שספציפי לאפליקציה.
- דוחות שימוש של משתמשים
מציגים את הפעילויות של המשתמשים בחשבון. אפשר להתאים אישית את הדוחות האלה ולסנן אותם כדי לקבל מידע ספציפי על השימוש. המידע הזה על השימוש מסודר לפי סוג האפליקציה ומכיל מידע שספציפי לאותה אפליקציה.
- דוחות שימוש בישויות
מפרטים את הפעילויות שקשורות לישויות שבהן משתמשים המשתמשים בחשבון באפליקציית Currents.
- התראות
- ה-Reports API מספק התראות שמאפשרות לכם לעקוב אחרי אירועים, כמו שינויים במשאבים. כשצופים במשאב והוא משתנה, ה-API של דוחות שולח לכם הודעה. מידע נוסף על הגדרה וקבלת התראות מ-Reports API זמין במדריך בנושא קבלת התראות Push.
השלבים הבאים
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
