שימוש בפרמטרים של 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 ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-03 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-03 (שעון UTC)."],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]
