- Yêu cầu HTTP
- Thông số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Hãy làm thử!
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
| Thông số | |
|---|---|
tasklist |
Giá trị nhận dạng danh sách việc cần làm. |
task |
Giá trị nhận dạng tác vụ. |
Tham số truy vấn
| Thông số | |
|---|---|
parent |
Không bắt buộc. 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. Ngoại lệ: 1. 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 được giao vào một việc cần làm mẹ (trở thành việc cần làm con). 2. Bạn không thể lồng các việc cần làm đã hoàn tất và bị ẩn, vì vậy, trường mẹ phải trống. |
previous |
Không bắt buộc. 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. Ngoại lệ: 1. Bạn chỉ có thể di chuyển các việc cần làm đã hoàn thành và bị ẩn sang vị trí 0, vì vậy, trường trước đó phải trống. |
destinationTasklist |
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. |
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.