קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
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.
דוחות על פעילות התחברות מספקים מידע על מועדי הכניסה והיציאה של המשתמשים בחשבון שלהם. לדוגמה, אפשר לקבל דוח על כל הכניסות לדומיין שלכם במהלך תקופת זמן מסוימת.
דוחות על פעילות של אסימוני OAuth
מפרטים אירועים שקורים כשמשתמשים מעניקים או מבטלים אסימוני הרשאה שמשמשים
אתרים ואפליקציות של צד שלישי. אתם יכולים להשתמש ב-Reports API כדי לקבל רשימה של כל הגישות של צד שלישי לנתונים של משתמש ב-Google Workspace.
דוחות שימוש
דוחות השימוש מספקים מידע על אירועים ב-Google Workspace בדומיין שלכם.
אפשר להשתמש ב-API כדי לבקש מידע ספציפי על משתמשים.
דוחות השימוש של הלקוחות מציגים רשימה של פעילויות מפורטות באפליקציות ובשירותים בחשבון שלכם. המידע הזה על השימוש מסודר לפי סוג האפליקציה ומכיל מידע שספציפי לאפליקציה.
דוחות שימוש של משתמשים
מציגים את הפעילויות של המשתמשים בחשבון. אפשר להתאים אישית את הדוחות האלה ולסנן אותם כדי לקבל מידע ספציפי על השימוש. המידע הזה על השימוש מסודר לפי סוג האפליקציה ומכיל מידע שספציפי לאותה אפליקציה.
דוחות שימוש בישויות
מפרטים את הפעילויות שקשורות לישויות שבהן משתמשים המשתמשים בחשבון באפליקציית Currents.
התראות
ה-Reports API מספק התראות שמאפשרות לכם לעקוב אחרי אירועים, כמו שינויים במשאבים. כשצופים במשאב והוא משתנה, ה-API של דוחות שולח לכם הודעה. מידע נוסף על הגדרה וקבלת התראות מ-Reports API זמין במדריך בנושא קבלת התראות Push.
השלבים הבאים
כדי לקבל מידע על Reports API ולראות איך הוא פועל, אפשר להשתמש במדריך להתחלה מהירה. המדריכים האלה מפורטים לפי שפת תכנות בסרגל הניווט הימני. אפשר גם להמשיך לקרוא את המידע הכללי על הגדרת החשבון.
בקטע הרשאה מוסבר איך להשתמש באסימוני גישה מסוג OAuth 2.0 כדי לקבל נתוני משתמשים מאפליקציות וממשקים של Google Workspace.
כדי למצוא את הפרטים של סוג משאב או שיטה ספציפיים, אפשר לעיין בהפניית ה-API.
[[["התוכן קל להבנה","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 (שעון 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)."]]
