งานสําหรับคําสั่งซื้อ

คุณจัดระเบียบงานตามลำดับเฉพาะเพื่อให้เหมาะกับความต้องการและความชอบของผู้ใช้ได้ คุณสามารถย้ายงานไปอยู่ใต้งานอื่น (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 ได้ขณะสร้างงานใหม่