ตั้งค่าในช่วงอย่างน้อย 1 ช่วงของสเปรดชีต ผู้โทรต้องระบุรหัสสเปรดชีต, valueInputOption
และ ValueRanges
อย่างน้อย 1 รายการ
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่จะอัปเดต |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "valueInputOption": enum ( |
ช่อง | |
---|---|
valueInputOption |
วิธีการตีความข้อมูลอินพุต |
data[] |
ค่าใหม่ที่จะนำไปใช้กับสเปรดชีต |
includeValuesInResponse |
กำหนดว่าการตอบกลับการอัปเดตควรมีค่าของเซลล์ที่มีการอัปเดตหรือไม่ โดยค่าเริ่มต้น คำตอบจะไม่รวมค่าที่อัปเดต ช่อง |
responseValueRenderOption |
กำหนดว่าควรแสดงผลค่าในการตอบกลับอย่างไร ตัวเลือกการแสดงผลเริ่มต้นคือ |
responseDateTimeRenderOption |
กำหนดวิธีแสดงผลวันที่ เวลา และระยะเวลาในการตอบกลับ ระบบจะไม่สนใจโค้ดนี้หาก |
เนื้อหาการตอบกลับ
คำตอบเมื่ออัปเดตช่วงของค่าในสเปรดชีต
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
ช่อง | |
---|---|
spreadsheetId |
สเปรดชีตที่ใช้การอัปเดต |
totalUpdatedRows |
จำนวนแถวทั้งหมดที่มีการอัปเดตอย่างน้อย 1 เซลล์ในแถว |
totalUpdatedColumns |
จำนวนคอลัมน์ทั้งหมดที่มีการอัปเดตอย่างน้อย 1 เซลล์ในคอลัมน์ |
totalUpdatedCells |
จำนวนเซลล์ทั้งหมดที่มีการอัปเดต |
totalUpdatedSheets |
จำนวนแผ่นงานทั้งหมดที่มีการอัปเดตอย่างน้อย 1 เซลล์ในชีต |
responses[] |
UpdateValuesResponse 1 รายการต่อช่วงที่ขอในลำดับเดียวกับที่คำขอปรากฏขึ้น |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์