העברת המשימה שצוינה למיקום אחר ברשימת משימות היעד. אם לא תציינו רשימת יעדים, המשימה תועבר לרשימה הנוכחית שלה. למשל, להציב משימה של ילד או ילדה במשימות של הורה חדש או להעביר אותה למיקום אחר בין המשימות האלה. לכל משימה יכולות להיות עד 2,000 תתי-משימות.
בקשת HTTP
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
tasklist |
מזהה רשימת המשימות. |
task |
מזהה המשימה. |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
parent |
מזהה חדש של משימות הורה. אם המשימה מועברת לרמה העליונה, הפרמטר הזה יושמט. אי אפשר להגדיר את המשימות שהוקצו כמשימות הורה (יש בהן תתי-משימות) או להעביר אותן למשימת הורה (כלומר, תתי-משימות). זה שינוי אופציונלי. |
previous |
מזהה המשימה הקודם והאחיד. אם המשימה מועברת למיקום הראשון בין שאר המשימה, הפרמטר הזה יושמט. זה שינוי אופציונלי. |
destinationTasklist |
זה שינוי אופציונלי. מזהה רשימת המשימות של היעד. אם מוגדרת, המשימה תועבר מרשימת המשימות לרשימת היעדTasklist. אחרת, המשימה תועבר לרשימה הנוכחית שלה. כרגע אי אפשר להעביר משימות חוזרות בין רשימות. זה שינוי אופציונלי. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Task.
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/tasks
מידע נוסף זמין במדריך להרשאות.