Method: tasks.move

وظیفه مشخص شده را به موقعیت دیگری در لیست وظایف مقصد منتقل می کند. اگر لیست مقصد مشخص نشده باشد، کار به لیست فعلی منتقل می شود. این می تواند شامل قرار دادن آن به عنوان یک وظیفه کودک زیر نظر یک والدین جدید و/یا انتقال آن به موقعیتی متفاوت در میان وظایف خواهر و برادرش باشد. یک کاربر می تواند تا 2000 کار فرعی در هر کار داشته باشد.

درخواست HTTP

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
tasklist

string

شناسه لیست وظایف

task

string

شناسه وظیفه

پارامترهای پرس و جو

پارامترها
parent

string

اختیاری. شناسه وظیفه والد جدید. اگر کار به سطح بالا منتقل شود، این پارامتر حذف می شود. مجموعه وظایف به عنوان والد باید در لیست کار وجود داشته باشد و نمی توان آن را پنهان کرد.

استثنائات: 1. وظایف محول شده را نمی توان به عنوان وظیفه والد تنظیم کرد (وظایف فرعی دارند) یا تحت یک وظیفه والد (تکلیف فرعی تبدیل شوند). 2. کارهایی که هم تکمیل شده و هم پنهان هستند را نمی توان تودرتو کرد، بنابراین قسمت والد باید خالی باشد.

previous

string

اختیاری. شناسه جدید وظیفه خواهر و برادر قبلی. اگر کار به موقعیت اول در بین خواهر و برادر منتقل شود، این پارامتر حذف می شود. مجموعه وظایف مانند قبلی باید در لیست کار وجود داشته باشد و نمی توان آن را پنهان کرد.

استثناها: 1. کارهایی که هم تکمیل شده و هم پنهان هستند را فقط می توان به موقعیت 0 منتقل کرد، بنابراین قسمت قبلی باید خالی باشد.

destinationTasklist

string

اختیاری. شناسه لیست کار مقصد. در صورت تنظیم، کار از لیست وظایف به لیست لیست مقصد منتقل می شود. در غیر این صورت کار به لیست فعلی خود منتقل می شود. کارهای تکراری در حال حاضر نمی توانند بین لیست ها جابجا شوند.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Task است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/tasks

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

،

وظیفه مشخص شده را به موقعیت دیگری در لیست وظایف مقصد منتقل می کند. اگر لیست مقصد مشخص نشده باشد، کار به لیست فعلی منتقل می شود. این می تواند شامل قرار دادن آن به عنوان یک وظیفه کودک زیر نظر یک والدین جدید و/یا انتقال آن به موقعیتی متفاوت در میان وظایف خواهر و برادرش باشد. یک کاربر می تواند تا 2000 کار فرعی در هر کار داشته باشد.

درخواست HTTP

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
tasklist

string

شناسه لیست وظایف

task

string

شناسه وظیفه

پارامترهای پرس و جو

پارامترها
parent

string

اختیاری. شناسه وظیفه والد جدید. اگر کار به سطح بالا منتقل شود، این پارامتر حذف می شود. مجموعه وظایف به عنوان والد باید در لیست کار وجود داشته باشد و نمی توان آن را پنهان کرد.

استثنائات: 1. وظایف محول شده را نمی توان به عنوان وظیفه والد تنظیم کرد (وظایف فرعی دارند) یا تحت یک وظیفه والد (تکلیف فرعی تبدیل شوند). 2. کارهایی که هم تکمیل شده و هم پنهان هستند را نمی توان تودرتو کرد، بنابراین قسمت والد باید خالی باشد.

previous

string

اختیاری. شناسه جدید وظیفه خواهر و برادر قبلی. اگر کار به موقعیت اول در بین خواهر و برادر منتقل شود، این پارامتر حذف می شود. مجموعه وظایف مانند قبلی باید در لیست کار وجود داشته باشد و نمی توان آن را پنهان کرد.

استثناها: 1. کارهایی که هم تکمیل شده و هم پنهان هستند را فقط می توان به موقعیت 0 منتقل کرد، بنابراین قسمت قبلی باید خالی باشد.

destinationTasklist

string

اختیاری. شناسه لیست کار مقصد. در صورت تنظیم، کار از لیست وظایف به لیست لیست مقصد منتقل می شود. در غیر این صورت کار به لیست فعلی خود منتقل می شود. کارهای تکراری در حال حاضر نمی توانند بین لیست ها جابجا شوند.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Task است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/tasks

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.