Method: tasks.list

מחזירה את כל המשימות ברשימת המשימות שצוינה.

בקשת 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

סוג המשאב. אלה תמיד "משימות#משימות".

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

סוג המשאב. אלה תמיד "משימות#משימות".

etag

string

ה-ETag של המשאב.

nextPageToken

string

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

items[]

object (Task)

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