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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
ช่อง
presentationId

string

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

object (Response)

การตอบกลับการอัปเดต ซึ่งจะสอดคล้องกับการอัปเดตแบบ 1:1 แม้ว่าการตอบกลับคำขอบางรายการอาจไม่มีข้อมูลก็ตาม
writeControl

object (WriteControl)

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

enum (CommentUpdateState)

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

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

ต้องใช้ขอบเขต 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

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

CommentUpdateState

สถานะของการอัปเดตความคิดเห็นในคำขอแบบกลุ่ม

Enum
COMMENT_UPDATE_STATE_UNSPECIFIED ไม่ได้ระบุสถานะของการอัปเดตความคิดเห็น
NO_UPDATES_REQUESTED ไม่มีการขออัปเดตความคิดเห็นในคำขอแบบกลุ่ม
ALL_SAVED การอัปเดตความคิดเห็นที่ขอทั้งหมดมีผลในคำขอแบบกลุ่มแล้ว
ALL_FAILED_UNKNOWN_REASON การอัปเดตความคิดเห็นที่ขอทั้งหมดไม่สำเร็จ