Method: tasks.move

Di chuyển việc cần làm đã chỉ định sang một vị trí khác trong danh sách việc cần làm đích. Nếu bạn không chỉ định danh sách đích, thì việc cần làm sẽ được di chuyển trong danh sách hiện tại. Điều này có thể bao gồm việc đặt tác vụ đó làm tác vụ con trong một tác vụ mẹ mới và/hoặc di chuyển tác vụ đó sang một vị trí khác trong số các tác vụ đồng cấp. Mỗi người dùng có thể có tối đa 2.000 việc cần làm phụ cho mỗi việc cần làm.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
tasklist

string

Giá trị nhận dạng danh sách việc cần làm.
task

string

Giá trị nhận dạng tác vụ.

Tham số truy vấn

Tham số
parent

string

Giá trị nhận dạng tác vụ mẹ mới. Nếu tác vụ được di chuyển lên cấp cao nhất, tham số này sẽ bị bỏ qua. Việc cần làm được đặt làm việc cần làm mẹ phải tồn tại trong danh sách việc cần làm và không được ẩn. Bạn không thể đặt việc cần làm được giao làm việc cần làm mẹ (có việc cần làm con) hoặc di chuyển việc cần làm mẹ (trở thành việc cần làm con). Không bắt buộc.
previous

string

Giá trị nhận dạng tác vụ đồng cấp trước đó mới. Nếu tác vụ được chuyển sang vị trí đầu tiên trong số các tác vụ đồng cấp, tham số này sẽ bị bỏ qua. Việc cần làm được đặt làm việc cần làm trước đó phải tồn tại trong danh sách việc cần làm và không được ẩn. Không bắt buộc.
destinationTasklist

string

Không bắt buộc. Giá trị nhận dạng danh sách việc cần làm đích. Nếu được đặt, tác vụ sẽ được chuyển từ danh sách việc cần làm sang danh sách destinationTasklist. Nếu không, việc cần làm sẽ được di chuyển trong danh sách hiện tại. Hiện tại, bạn không thể di chuyển việc cần làm định kỳ giữa các danh sách. Không bắt buộc.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Task.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.