Method: activity.query

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

גוף הבקשה

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

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

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