คุณจัดระเบียบงานตามลำดับที่เฉพาะเจาะจงเพื่อให้เหมาะกับความต้องการและค่ากำหนดของผู้ใช้ได้
คุณสามารถย้ายงานไปไว้ใต้งานอื่น (parent งาน) หรือ
ไปไว้หลังงานอื่น (previous)

หากต้องการย้ายงาน ให้ส่งคำขอ POST ที่ผ่านการตรวจสอบสิทธิ์ไปยัง URL ต่อไปนี้
พร้อมพารามิเตอร์พิเศษต่อไปนี้
- พารามิเตอร์
parent - ระบุรหัสของงานหลักที่จะแทรกงานใหม่ไว้ใต้ โดยการละเว้นพารามิเตอร์นี้จะทำให้งานอยู่ในระดับบนสุดของรายการ
- พารามิเตอร์
previous - ระบุรหัสของงานหลังจากที่ควรแทรกงานใหม่ การละเว้นพารามิเตอร์นี้จะวางงานไว้ในตำแหน่งแรกของรายการย่อย
URL มีรูปแบบดังนี้
https://www.googleapis.com/tasks/v1/lists/taskListID/tasks/taskID/move?parent=parentTaskID&previous=previousTaskID
โดยใช้ค่าที่เหมาะสมแทน taskListID, taskID, parentTaskID และ previousTaskID
หมายเหตุ: คุณใช้ค่าพิเศษ taskListID
@default เพื่ออ้างอิงรายการงานเริ่มต้นของ
ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ได้
หากสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วยรหัสสถานะ HTTP 200 OK
และข้อมูลงานใหม่
ตัวอย่าง
โปรโตคอล
คำขอ
POST /tasks/v1/lists/@default/tasks/taskID/move?parent=parentTaskID\ &previous=previousTaskID
คำตอบ:
HTTP/1.1 200 OK { id: "taskID", kind: "tasks#task", selfLink: "https://www.googleapis.com/tasks/v1/lists/@default/tasks/\ taskID", etag: "newETag", title: "New Task", notes: "Please complete me", updated: "2010-10-15T11:30:00.000Z", ..., parent: "parentTaskID", position: "newPosition", ... }
Java
import com.google.api.services.tasks.v1.Tasks.TasksOperations.Move; ... Move move = service.tasks.move("@default", "taskID"); move.setParent("parentTaskID"); move.setPrevious("previousTaskID"); Task result = move.execute(); // Print the new values. System.out.println(result.getParent()); System.out.println(result.getPosition());
Python
result = service.tasks().move(tasklist='@default', task='taskID',\ parent='parentTaskID',\ previous='previousTaskID').execute() # Print the new values. print result['parent'] print result['position']
PHP
$result = $service->moveTasks('taskID', '@default', null, 'parentTaskID', 'previousTaskID'); /* * Print the new values. */ echo $result->getParent(); echo $result->getPosition();
.NET
Task result = service.Tasks.Move("@default", "taskID", parent: "parentTaskID", previous: "previousTaskID").Fetch(); // Print the new values. Console.WriteLine(result.Parent); Console.WriteLine(result.Position);
หมายเหตุ: คุณยังใช้พารามิเตอร์ parent และ previous
ขณะสร้างงานใหม่ได้ด้วย