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 של משתמש מסוים, יש להשתמש ב- בקשת GET של HTTP עם אסימון ההרשאה המתואר ב מדריך למדריך להרשאות. השדה userKey מייצג את כתובת האימייל הראשית של המשתמש בדוח, או all לכל המשתמשים.

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

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

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

אפשר לאחזר דוח של פעילויות ב-Google Drive של קובץ משותף ספציפי של Drive באמצעות בקשת GET של HTTP עם אסימון ההרשאה המתואר ב המדריך להרשאות. יש לציין את כתובת האימייל של המשתמש שעליו רוצים להריץ את הדוח בשדה 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 לפי סוג אירוע

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

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

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

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

כששולחים בקשת GET מסוג HTTP ל-API, תשובה מוצלחת מחזירה קוד הסטטוס HTTP 200. יחד עם קוד הסטטוס, התשובה תחזיר דוח ל-Drive. הדוחות האלה זמינים גם מסוף Admin. מידע נוסף זמין במאמר מרכז העזרה לאדמינים ב-Google Workspace. לקבלת מידע נוסף על eventName, אפשר לעיין ב שמות של אירועים ב-Drive הפניה. לקבלת מידע נוסף על מחרוזות השאילתה של הבקשה ועל מאפייני תגובה, ראו הפניית 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"
      }
      ]
     }
    ]
   },
  ]
 }