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