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. פעולות דומות שמתרחשות בפרק זמן מסוים יכולות להיות מקובצות בין יעדים מרובים (למשל, העברה של קבוצת קבצים בו-זמנית) או מספר גורמים (למשל, כמה משתמשים שעורכים את אותו פריט). כללי הקיבוץ בשיטה הזו הם ספציפיים לכל סוג של פעולה.