Reports API: דוח פעילות ב-Drive

בדוח הפעילות ב-Drive מופיע מידע על הפעילויות של המשתמשים כשמנהלים, משנים ומשתפים קבצים ב-Google Drive ב-Google Workspace. לדוגמה, אפשר להשתמש בדוח הפעילות ב-Drive כדי לקבל רשימה של כל המסמכים החדשים ב-Drive שנוצרו על ידי משתמש מסוים בטווח תאריכים ספציפי. אפשר להשתמש במידע הזה כדי לקבל תובנות לגבי ניהול תוכן טוב יותר ודליפות נתונים אפשריות. כדי לקבל דוח, משתמשים בבקשת נקודת הקצה של הדוח הבסיסי עם פרמטרים ספציפיים לדוח, כמו כתובת אימייל של משתמש או סוג מסוים של שינוי ב-Google Drive. בדוחות אפשר לכלול נתונים מ-180 הימים האחרונים לכל היותר.

אפשר להשתמש בדוח הפעילות ב-Google Drive רק למטרות חוקיות בחשבונות שהוקצה להם רישיון.

מידע על מחרוזות השאילתה של הבקשה ומאפייני התגובה מופיע בהפניית ה-API. למידע על אירועים ספציפיים שקשורים ל-Google Drive, אפשר לעיין בשמות האירועים ב-Drive.

אחזור אירועים ב-Google Drive עבור דומיין

אתם יכולים להשתמש בדוח הפעילות ב-Drive כדי לראות מידע על מסמכי Drive. לדוגמה, אפשר לבקש דוח עם 25 האירועים האחרונים בחשבון שלכם ב-Drive, שמתייחסים לתקופה של עד 180 ימים. כדי לקבל את הדוח הזה, צריך להשיג אסימון הרשאה כמו שמתואר במדריך ההרשאות, ואז להשתמש בבקשת ה-HTTP GET הבאה:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

אפשר לראות דוגמה לתגובה לקריאה הזו ל-API.

בדוגמה הבאה מאחזרים דוח של כל האירועים ב-Drive ב-180 הימים האחרונים, התקופה המקסימלית.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

אחזור אירועים ב-Google Drive לפי משתמש

כדי לאחזר דוח של פעילויות ב-Google Drive של משתמש מסוים, משתמשים בבקשת HTTP GET עם טוקן ההרשאה שמתואר במדריך הרשאה. השדה userKey הוא כתובת האימייל הראשית של המשתמש בדוח, או all עבור כל המשתמשים.

בדוגמה הבאה מאחזרים דוח עם רשימה של כל השינויים שבוצעו על ידי המשתמש שצוין. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

אחזור אירועים ב-Google Drive עבור תיקיות אחסון שיתופי

אפשר לאחזר דוח של פעילויות ב-Google Drive עבור תיקייה ספציפית ב-Drive המשותף באמצעות בקשת HTTP GET עם אסימון ההרשאה שמתואר במדריך ההרשאה. בשדה userKey, מציינים את כתובת האימייל של המשתמש שעליו רוצים להריץ את הדוח, או מציינים all כדי להריץ את הדוח על כל המשתמשים.

בדוגמה הבאה מאחזרים דוח של כל השינויים בתיקיית אחסון שיתופי ספציפית. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>

כדי לאחזר אירועים של אחסון שיתופי, מסננים באמצעות doc_type. בדוגמה הבאה מאחזרים אירועים שמשפיעים על כל תיקיות האחסון השיתופי:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive

כדי לאחזר אירועים של שינויים במינויים, מציינים את shared_drive_membership_change האירוע. בדוגמה הבאה מאחזרים את כל החברים שנוספו לתיקיות באחסון השיתופי:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive

אחזור אירועים ב-Google Drive לפי סוג האירוע

כדי לאחזר דוח של כל המקרים של סוג אירוע ספציפי, כמו יצירה או עריכה של מסמך, משתמשים בבקשת HTTP GET עם אסימון ההרשאה שמתואר במדריך ההרשאה. השדה userKey הוא כתובת האימייל הראשית של המשתמש בדוח, או all עבור כל המשתמשים.

בדוגמה הבאה מאחזרים דוח של כל הפעילויות שקשורות ליצירת תיעוד של החשבון. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

דוגמה לתגובת JSON

כששולחים בקשת HTTP GET ל-API, תגובה מוצלחת מחזירה קוד סטטוס HTTP 200. בנוסף לקוד הסטטוס, התשובה מחזירה דוח ל-Drive. הדוחות האלה זמינים גם במסוף Admin. מידע נוסף זמין במרכז העזרה לאדמינים של Google Workspace. מידע נוסף זמין במאמר בנושא שמות של אירועים ב-Drive.eventName מידע נוסף על מחרוזות השאילתות של הבקשה ומאפייני התגובה זמין בהפניית ה-API.

{
 "kind": "reports#auditActivities",
 "nextPageToken": "next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2014-03-17T15:39:18.460Z",
    "uniqQualifier": "report's unique ID",
    "applicationName": "drive",
    "customerId": "ABC123xyz"
   },
   "actor": {
   "callerType": "USER",
   "email": "kim@example.com",
   "profileId": "user's unique Google Workspace profile ID",
   "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "domain of the source owner",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "access",
     "name": "edit",
     "parameters": [
      {
        "name": "primary_event",
        "boolValue": true
      },
      {
        "name": "owner_is_shared_drive",
        "boolValue": false
      },      {
        "name": "doc_id",
        "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
      },
      {
        "name": "doc_title",
        "value": "Meeting notes"
      },
      {
        "name": "doc_type",
        "value": "document"
      },
      {
        "name": "owner",
        "value": "mary@example.com"
      }
      ]
     }
    ]
   },
  ]
 }