Method: tasks.list

מחזירה את כל המשימות מרשימת המשימות שצוינה. הוא לא מחזיר את המשימות שהוקצו כברירת מחדל (מ-Docs, ממרחבים ב-Chat). כל רשימה יכולה לכלול עד 20,000 משימות לא מוסתרות ועד 100,000 משימות בכל פעם.

בקשת HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

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

פרמטרים של נתיב

פרמטרים
tasklist

string

מזהה רשימת המשימות.

פרמטרים של שאילתה

פרמטרים
completedMax

string

גבול עליון לתאריך ההשלמה של המשימה (כחותמת זמן של RFC 3339) שיש לסנן לפיו. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך השלמה.
completedMin

string

גבול תחתון לתאריך הסיום של המשימה (כחותמת זמן של RFC 3339) שיש לסנן לפיו. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך השלמה.
dueMax

string

גבול עליון לתאריך היעד של המשימה (כחותמת זמן של RFC 3339) שיש לסנן לפיו. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך יעד.
dueMin

string

גבול תחתון של תאריך היעד של המשימה (כחותמת זמן של RFC 3339) שיש לסנן לפיו. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך יעד.
maxResults

integer

המספר המקסימלי של משימות שהוחזרו בדף אחד. זה שינוי אופציונלי. ברירת המחדל היא 20 (המקסימום המותר: 100).
pageToken

string

אסימון שמציין את דף התוצאות שצריך להחזיר. זה שינוי אופציונלי.
showCompleted

boolean

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

boolean

סימון שמציין אם משימות שנמחקו מוחזרות בתוצאה. זה שינוי אופציונלי. ערך ברירת המחדל הוא False.
showHidden

boolean

סימון שמציין אם משימות מוסתרות מוחזרות בתוצאה. זה שינוי אופציונלי. ערך ברירת המחדל הוא False.
updatedMin

string

גבול תחתון של זמן השינוי האחרון של משימה (כחותמת זמן של RFC 3339) שיש לסנן לפיו. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי מועד השינוי האחרון.
showAssigned

boolean

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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

ייצוג JSON 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
שדות
kind

string

סוג המשאב. ההגדרה הזו תמיד היא 'tasks#tasks'.
etag

string

ה-ETag של המשאב.
nextPageToken

string

האסימון שמשמש לגישה לדף הבא בתוצאה הזו.
items[]

object (Task)

אוסף של משימות.

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

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

Tasks

ייצוג JSON 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
שדות
kind

string

סוג המשאב. ההגדרה הזו תמיד היא 'tasks#tasks'.
etag

string

ה-ETag של המשאב.
nextPageToken

string

האסימון שמשמש לגישה לדף הבא בתוצאה הזו.
items[]

object (Task)

אוסף של משימות.