Method: activity.query

הרצת שאילתות על פעילות קודמת ב-Google Drive.

בקשת HTTP

POST https://driveactivity.googleapis.com/v2/activity:query

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
שדות
consolidationStrategy

object (ConsolidationStrategy)

פרטים על איחוד הפעולות הקשורות שמהן מורכב הפעילות. אם המדיניות לא מוגדרת, הפעולות הקשורות לא מאוחדות.
pageSize

integer

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

string

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

string

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

שדות נתמכים:

  • time: משתמש באופרטורים מספריים בערכי תאריך במונחים של אלפיות שנייה החל מ-1 בינואר 1970 או בפורמט RFC 3339. דוגמאות:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: נעשה שימוש באופרטור "has" (:) ובערך יחיד או ברשימה של סוגי פעולות מותרים, כאשר הם מוקפים בסוגריים, מופרדים ברווח. כדי שלא לכלול תוצאה מהתגובה, מוסיפים מקף (-) בתחילת מחרוזת המסנן. דוגמאות:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
שדה איחוד key. הקריטריונים הראשיים בשאילתה. אם לא צוין מפתח, ברירת המחדל היא ancestorName = items/root. הערך של key יכול להיות רק אחת מהאפשרויות הבאות:
itemName

string

החזר פעילויות עבור הפריט הזה ב-Drive. הפורמט הוא items/ITEM_ID.
ancestorName

string

החזר פעילויות עבור התיקייה הזו ב-Drive, כולל כל הילדים והצאצאים. הפורמט הוא items/ITEM_ID.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

הודעת תגובה להרצת שאילתה על פעילות ב-Drive.

ייצוג JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
שדות
activities[]

object (DriveActivity)

רשימת הפעילויות המבוקשות.
nextPageToken

string

אסימון לאחזור דף התוצאות הבא, או ריק אם אין עוד תוצאות ברשימה.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

למידע נוסף, ניתן לעיין במדריך ההרשאות.

ConsolidationStrategy

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

ייצוג JSON 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
שדות
שדה איחוד strategy. איך פעילויות נפרדות אוחדו. הערך של strategy יכול להיות רק אחת מהאפשרויות הבאות:
none

object (NoConsolidation)

הפעילויות הבודדות לא מאוחדות.
legacy

object (Legacy)

הפעילויות הבודדות אוחדו באמצעות השיטה הקודמת.

NoConsolidation

אסטרטגיה שלא מאחדת פעילויות נפרדות.

הדור הקודם

אסטרטגיה שמאחדת פעילויות באמצעות כללי הקיבוץ מ-V1 Activity API הקודם. ניתן לקבץ פעולות דומות המתרחשות בתוך פרק זמן מסוים בין יעדים מרובים (כגון העברה של קבוצת קבצים בו-זמנית) או על ידי מספר גורמים (כגון מספר משתמשים שעורכים את אותו פריט). כללי הקיבוץ באסטרטגיה הזו הם ספציפיים לכל סוג פעולה.