Method: tasks.list

מחזירה את כל המשימות ברשימת המשימות שצוינה. בכל רשימה יכולות להיות עד 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

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

boolean

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

boolean

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

string

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

גוף הבקשה

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

גוף התשובה

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

ייצוג 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

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

משימות

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

string

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

string

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

string

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

object (Task)

אוסף משימות.