Google Drive Activity API מורכב מהמשאב DriveActivity
שמייצג שינויים שבוצעו באובייקטים ב-Google Drive של המשתמש, והשיטה activity.query
שמאפשרת לאחזר מידע על השינויים האלה.
בקשה
האפליקציה מבקשת נתוני פעילות של משתמש באמצעות השיטה activity.query
. אפשר לבקש פעילות לפריט ספציפי ב-Drive או לכל מה שנמצא בתיקייה ב-Drive. בתגובה לבקשה מסוימת, אתם יכולים להגביל את התגובה באמצעות מגבלות כמו טווח הזמן או סוג הפעולה, ואפשר לבחור שהפעילות תאוחד בתגובה. מידע נוסף זמין במאמר שליחת בקשות ב-Drive Activity API.
תשובה
התגובה לבקשה היא רשימה של פעילויות שתואמות לפרמטרים הנתונים, כאשר משאב DriveActivity
מייצג כל פעילות:
משאב 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.