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

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

previous

string

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

destination Tasklist

string

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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