מבוא ל-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.