שימוש בפרמטרים של Tasks
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בנוסף לפרמטרים הרגילים של שאילתה שבהם אפשר להשתמש ברוב ממשקי Google API, יש קבוצה של פרמטרים של Tasks.
בטבלה הבאה מפורטים הפרמטרים של הבקשות החלים רק על פעולות ספציפיות ב-Google Tasks API. כל ערכי הפרמטרים צריכים להיות בקידוד כתובות URL.
| פרמטר |
משמעות |
הערות |
רלוונטי |
completedMax |
גבול עליון לתאריך הסיום של משימה (כחותמת זמן בתקן RFC 3339) לסינון לפיה. |
- ברירת מחדל:
completedMax=2031-01-01
- צריך להשתמש בחותמת הזמן RFC 3339 לדוגמה:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
סף תחתון לתאריך ההשלמה של משימה (כחותמת זמן בתקן RFC 3339) כדי לסנן לפיה. |
- ברירת מחדל:
completedMin=1970-01-01
- צריך להשתמש בחותמת הזמן RFC 3339 לדוגמה:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
גבול עליון לתאריך היעד של משימה (כחותמת זמן של RFC 3339) לסינון לפיה. |
- ברירת מחדל:
dueMax=2031-01-01
- צריך להשתמש בחותמת הזמן RFC 3339 לדוגמה:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
גבול תחתון לתאריך היעד של משימה (כחותמת זמן RFC 3339) לסינון לפיה. |
- ברירת מחדל:
dueMin=1970-01-01
- צריך להשתמש בחותמת הזמן RFC 3339 לדוגמה:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
מספר הרכיבים המקסימלי שיש להחזיר עם הבקשה הזו. |
- ברירת מחדל:
maxResults=20
- הערך המקסימלי המותר:
maxResults=100.
|
- אחזור רשימות משימות של משתמש
- המערכת מאחזרת את המשימות
|
pageToken |
אסימון שמציין את דף התוצאות שיש להחזיר. |
- ברירת המחדל היא החזרת הדף הראשון.
|
- אחזור רשימות משימות של משתמש
- המערכת מאחזרת את המשימות
|
parent |
צריך לציין את מזהה המשימה הראשית של המשימה. |
- אין פרמטר שמציין הוספה או מעבר לרמה העליונה של רשימת המשימות.
|
|
previous |
מציינים את מזהה המשימה הקודמת של המשימה. |
- אף פרמטר אינו מציין הכנסה או מעבר למיקום הראשון ברשימת המשנה.
|
|
showCompleted |
אפשר לבחור אם להציג משימות שהושלמו או לא. |
- ברירת מחדל:
showCompleted=true
|
|
showDeleted |
אפשר לבחור אם להציג משימות שנמחקו או לא. |
- ברירת מחדל:
showDeleted=false
|
|
showHidden |
אפשר לבחור אם להציג או להסתיר משימות. |
- ברירת מחדל:
showHidden=true
|
|
updatedMin |
גבול תחתון למועד השינוי האחרון של משימה (כחותמת זמן של RFC 3339) לסינון לפיה. |
- צריך להשתמש בחותמת הזמן RFC 3339 לדוגמה:
2010-08-09T10:57:00.000-08:00Z.
- ברירת המחדל היא לא לסנן לפי מועד השינוי האחרון.
|
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]
