מבוא ל-Google Drive Activity API

Google Drive Activity API מורכב מהמשאב DriveActivity שמייצג שינויים שבוצעו באובייקטים ב-Google Drive של המשתמש, והשיטה activity.query שמאפשרת לאחזר מידע על השינויים האלה.

בקשה

האפליקציה מבקשת נתוני פעילות של משתמש באמצעות השיטה activity.query. אפשר לבקש פעילות לפריט ספציפי ב-Drive או לכל מה שנמצא בתיקייה ב-Drive. בתגובה לבקשה מסוימת, אתם יכולים להגביל את התגובה באמצעות מגבלות כמו טווח הזמן או סוג הפעולה, ואפשר לבחור שהפעילות תאוחד בתגובה. מידע נוסף זמין במאמר שליחת בקשות ב-Drive Activity API.

תשובה

התגובה לבקשה היא רשימה של פעילויות שתואמות לפרמטרים הנתונים, כאשר משאב DriveActivity מייצג כל פעילות:

הסבר על הפעילות ב-Drive.

משאב DriveActivity הוא אוסף של Action אובייקטים, שכל אחד מהם עומד בפני עצמו כמו אירוע. Action כולל ActionDetail (כמו Create או Edit), Actor (כמו User או Administrator), Target (למשל DriveItem או Drive) וגם Timestamp או TimeRange.

משאב DriveActivity מכיל גם מידע סיכום, כמו כל Actor ו-Target מכל הפעולות, Timestamp או TimeRange מאוחדים, והחלק החשוב או הנציג הכי חשוב ActionDetail של Action.

מידע נוסף זמין במאמר על מודל הנתונים ב-Drive Activity API.

הרשאות גישה להיסטוריית הפעילות

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

הרשאות הגישה מבוססות על ההרשאות שהוגדרו לאובייקט. יש מספר תרחישים של שיתוף קבצים ותיקיות ב-Drive:

  • אם מחבר משתף מסמך, היסטוריית הפעילות של המסמך גלויה לא רק ליוצר, אלא גם למשתמשים המאומתים שאיתם המסמך שותף.
  • אם שותף מסמך ואז הוגדר כפרטי, המשתמש המאומת יכול לראות את כל היסטוריית הפעילות כל עוד הייתה לו גישה, ושההרשאות מוגבלות עכשיו.
  • אם מסמך מעולם לא שותף עם משתמש, המשתמש לא יוכל לראות את היסטוריית הפעילות.

שנתחיל?

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