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