Method: presentations.batchUpdate

ใช้การอัปเดตกับงานนําเสนอ

request แต่ละรายการได้รับการตรวจสอบก่อนที่จะนําไปใช้ หากคําขอใดไม่ถูกต้อง คําขอทั้งหมดจะไม่สําเร็จและจะไม่มีการดําเนินการใดๆ

คําขอบางฉบับมี replies เพื่อให้ข้อมูลเกี่ยวกับวิธีการนําไปใช้ คําขออื่นๆ ไม่จําเป็นต้องส่งคืนข้อมูล คําขอเหล่านี้จะส่งการตอบกลับที่ว่างเปล่า ลําดับของการตอบกลับจะตรงกับลําดับของคําขอ

ตัวอย่างเช่น สมมติว่าคุณเรียก bundleUpdate ที่มีการอัปเดตสี่รายการ และมีเพียงการอัปเดตครั้งที่สามเท่านั้นที่ส่งคืนข้อมูล คําตอบจะมีการตอบกลับที่ว่างเปล่า 2 รายการ ได้แก่ การตอบกลับคําขอที่สาม และการตอบกลับที่ว่างเปล่าอีกรายการหนึ่งตามลําดับ

เนื่องจากผู้ใช้รายอื่นอาจแก้ไขงานนําเสนอ ดังนั้นงานนําเสนอนี้อาจไม่ได้แสดงการเปลี่ยนแปลงของคุณอย่างสมบูรณ์: การเปลี่ยนแปลงของคุณอาจเปลี่ยนแปลงไปตามการเปลี่ยนแปลงของผู้ทํางานร่วมกัน หากไม่มีผู้ทํางานร่วมกัน งานนําเสนอควรแสดงถึงการเปลี่ยนแปลงของคุณ ไม่ว่าในกรณีใดก็ตาม การอัปเดตในคําขอของคุณจะรวมอยู่ด้วยกันแบบอะตอม

คำขอ HTTP

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

งานนําเสนอที่จะนําการอัปเดตไปใช้

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

เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
ช่อง
requests[]

object (Request)

รายการอัปเดตที่จะใช้กับงานนําเสนอ
writeControl

object (WriteControl)

ให้การควบคุมวิธีการเรียกใช้คําขอเขียน

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

ข้อความตอบกลับจากการอัปเดตเป็นกลุ่ม

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
ช่อง
presentationId

string

งานนําเสนอที่นําการอัปเดตไปใช้
replies[]

object (Response)

การตอบกลับการอัปเดต การดําเนินการนี้จะจับคู่การอัปเดตแบบ 1:1 กับการอัปเดต แต่การตอบกลับคําขอบางรายการอาจว่างเปล่า
writeControl

object (WriteControl)

การควบคุมการเขียนที่อัปเดตหลังจากใช้คําขอ

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

ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์

การควบคุมการเขียน

ให้การควบคุมวิธีการเรียกใช้คําขอเขียน

การแสดง JSON 
{
  "requiredRevisionId": string
}
ช่อง
requiredRevisionId

string

revision ID ของงานนําเสนอที่ต้องใช้สําหรับคําขอเขียน หากระบุไว้และ ID การแก้ไขที่จําเป็นไม่ตรงกับรหัสการแก้ไขปัจจุบันของงานนําเสนอ คําขอจะไม่ได้รับการดําเนินการและแสดงข้อผิดพลาด 400 ที่ไม่ถูกต้อง

เมื่อมีการส่งคืนรหัสการแก้ไขที่ต้องระบุในการตอบกลับ รหัสการตรวจสอบของเอกสารจะแสดงหลังจากที่ใช้คําขอ