מבוא ל-Google Drive Activity API

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

בקשה

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

תשובה

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

הסבר על 'פעילות ב-Google 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.

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

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

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

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

שנתחיל?

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