ה-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.