Method: spreadsheets.batchUpdate

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

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

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

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

คำขอ 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

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