מחזירה את כל המשימות ברשימת המשימות שצוינה. בכל רשימה יכולות להיות עד 20,000 משימות לא מוסתרות ועד 100,000 משימות בסך הכול.
בקשת HTTP
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
tasklist |
מזהה של רשימת המשימות. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
completedMax |
הגבול העליון של תאריך ההשלמה של המשימה (כחותמת זמן RFC 3339) שלפיו יש לסנן. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך הסיום. |
completedMin |
הגבול התחתון לתאריך ההשלמה של המשימה (כחותמת זמן RFC 3339) שלפיו יש לסנן. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך הסיום. |
dueMax |
הגבול העליון של תאריך היעד של המשימה (כחותמת זמן RFC 3339) שלפיו יש לסנן. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך יעד. |
dueMin |
הגבול התחתון לתאריך היעד של המשימה (כחותמת זמן RFC 3339) שלפיו יש לסנן. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי תאריך יעד. |
maxResults |
המספר המקסימלי של משימות שהוחזרו בדף אחד. זה שינוי אופציונלי. ברירת המחדל היא 20 (המקסימום מותר: 100). |
pageToken |
אסימון שמציין את דף התוצאות שיש להחזיר. זה שינוי אופציונלי. |
showCompleted |
סימון שמציין אם משימות שהושלמו מוחזרות בתוצאה זה שינוי אופציונלי. ברירת המחדל היא True. חשוב לזכור שהשדה 'הצגה מוסתרת' חייב להיות גם מוגדר כ-True כדי להציג משימות שהושלמו בלקוחות צד ראשון, כמו ממשק המשתמש באינטרנט והאפליקציות של Google לנייד. |
showDeleted |
סימון שמציין אם משימות שנמחקו מוחזרות בתוצאה זה שינוי אופציונלי. ברירת המחדל היא False. |
updatedMin |
הגבול התחתון של מועד השינוי האחרון של המשימה (כחותמת זמן RFC 3339) שלפיו יש לסנן. זה שינוי אופציונלי. ברירת המחדל היא לא לסנן לפי מועד השינוי האחרון. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
שדות | |
---|---|
kind |
סוג המשאב. זה תמיד "tasks#tasks". |
etag |
ה-ETag של המשאב. |
nextPageToken |
האסימון משמש לגישה לדף הבא של התוצאה הזו. |
items[] |
אוסף משימות. |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/tasks
https://www.googleapis.com/auth/tasks.readonly
למידע נוסף, עיינו במדריך ההרשאות.
משימות
ייצוג JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
שדות | |
---|---|
kind |
סוג המשאב. זה תמיד "tasks#tasks". |
etag |
ה-ETag של המשאב. |
nextPageToken |
האסימון משמש לגישה לדף הבא של התוצאה הזו. |
items[] |
אוסף משימות. |