Method: presentations.batchUpdate

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

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

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

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

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

คำขอ 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 คำขอผิดพลาด

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