Method: tasks.move

ย้ายงานที่ระบุไปยังตำแหน่งอื่นในรายการงานปลายทาง หากไม่ได้ระบุรายการปลายทาง ระบบจะย้ายงานภายในรายการปัจจุบัน ซึ่งอาจรวมถึงการทำให้งานเป็นงานย่อยภายใต้งานหลักใหม่ และ/หรือย้ายงานไปยังตำแหน่งอื่นในบรรดางานพี่น้อง ผู้ใช้จะมีงานย่อยได้สูงสุด 2,000 งานต่องาน

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
tasklist

string

ตัวระบุรายการงาน
task

string

ตัวระบุงาน

พารามิเตอร์การค้นหา

พารามิเตอร์
parent

string

ไม่บังคับ ตัวระบุงานหลักใหม่ หากย้ายงานไปยังระดับบนสุด ระบบจะไม่ใส่พารามิเตอร์นี้ งานที่ตั้งเป็นงานหลักต้องอยู่ในรายการงานและซ่อนไม่ได้

ข้อยกเว้น: 1. ไม่สามารถตั้งค่างานที่มอบหมายเป็นงานหลัก (มีงานย่อย) หรือย้ายไปไว้ใต้งานหลัก (กลายเป็นงานย่อย) 2. งานที่ทำเสร็จแล้วและซ่อนอยู่จะฝังไม่ได้ ดังนั้นฟิลด์หลักจึงต้องว่างเปล่า
previous

string

ไม่บังคับ ตัวระบุงานก่อนหน้าแบบใหม่ หากย้ายงานไปยังตำแหน่งแรกในบรรดางานพี่น้อง ระบบจะไม่ใส่พารามิเตอร์นี้ งานที่ตั้งเป็น "ก่อนหน้า" ต้องอยู่ในรายการงานและซ่อนไม่ได้

ข้อยกเว้น: 1. งานที่ทำเสร็จแล้วและซ่อนไว้จะย้ายไปยังตำแหน่ง 0 ได้เท่านั้น ดังนั้นช่องก่อนหน้าจึงต้องว่างเปล่า
destinationTasklist

string

ไม่บังคับ ตัวระบุรายการงานปลายทาง หากตั้งค่าไว้ ระบบจะย้ายงานจาก tasklist ไปยังรายการ destinationTasklist ไม่เช่นนั้น ระบบจะย้ายงานภายในรายการปัจจุบัน ขณะนี้คุณไม่สามารถย้ายงานที่เกิดซ้ำระหว่างรายการได้

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Task

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์