ตั้งค่าของสเปรดชีตตั้งแต่ 1 ช่วงขึ้นไป ผู้โทรต้องระบุรหัสสเปรดชีต valueInputOption
และ ValueRanges
อย่างน้อย 1 รายการ
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
URL ใช้ไวยากรณ์ gRPC Transcoding
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
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 |
จํานวนรวมของคอลัมน์ที่มีการอัปเดตอย่างน้อยหนึ่งเซลล์ในคอลัมน์ |
totalUpdatedCells |
จํานวนเซลล์ทั้งหมดที่อัปเดต |
totalUpdatedSheets |
จํานวนรวมของแผ่นงานที่ได้รับการอัปเดตอย่างน้อย 1 เซลล์ในแผ่นงาน |
responses[] |
UpdateValuesResponse หนึ่งช่วงต่อช่วงคําขอ โดยเรียงลําดับตามที่แสดงคําขอ |
ขอบเขตการให้สิทธิ์
ต้องการขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์