Method: spreadsheets.batchUpdate

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

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

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

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

คำขอ HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

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

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

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

string

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

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

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
ช่อง
requests[]

object (Request)

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

boolean

กำหนดว่าคำตอบการอัปเดตควรรวมทรัพยากรสเปรดชีตหรือไม่
responseRanges[]

string

จำกัดช่วงที่อยู่ในสเปรดชีตคำตอบ มีผลเฉพาะในกรณีที่ includeSpreadsheetInResponse เป็น "จริง"
responseIncludeGridData

boolean

จริงหากต้องการให้แสดงข้อมูลตารางกริด มีผลเฉพาะในกรณีที่ includeSpreadsheetInResponse เป็น "จริง" ระบบจะละเว้นพารามิเตอร์นี้หากมีการตั้งค่ามาสก์ช่องในคําขอ

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

การตอบกลับสำหรับการอัปเดตสเปรดชีตแบบเป็นกลุ่ม

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

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

string

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

object (Response)

การตอบกลับการอัปเดต ซึ่งจะเชื่อมโยงกับข้อมูลอัปเดตแบบ 1:1 แม้ว่าการตอบกลับคำขอบางรายการอาจว่างเปล่า
updatedSpreadsheet

object (Spreadsheet)

สเปรดชีตหลังจากใช้การอัปเดต ระบบจะตั้งค่านี้เฉพาะในกรณีที่ BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response เป็น true

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

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

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

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