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