Method: presentations.batchUpdate

ใช้การอัปเดตอย่างน้อย 1 รายการกับงานนำเสนอ

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

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

ตัวอย่างเช่น สมมติว่าคุณเรียกใช้ batchUpdate ด้วยอัปเดต 4 รายการ และมีเพียงรายการที่ 3 เท่านั้นที่แสดงผลข้อมูล การตอบกลับจะมีคำตอบว่างเปล่า 2 รายการ ได้แก่ การตอบกลับคำขอที่ 3 และการตอบกลับว่างเปล่าอีกรายการตามลำดับ

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

คำขอ HTTP

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

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

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

พารามิเตอร์
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

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

WriteControl

ให้การควบคุมวิธีดำเนินการกับคำขอเขียน

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

string

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

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