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