- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- ลองใช้งาน
ตั้งค่าในช่วงของสเปรดชีตอย่างน้อย 1 ช่วง ผู้โทรต้องระบุรหัสสเปรดชีต, valueInputOption
และ DataFilterValueRanges
อย่างน้อย 1 รายการ
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่จะอัปเดต |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "valueInputOption": enum ( |
ช่อง | |
---|---|
valueInputOption |
วิธีตีความข้อมูลอินพุต |
data[] |
ค่าใหม่ที่จะใช้กับสเปรดชีต หากมีมากกว่า 1 ช่วงที่ตรงกับ |
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[] |
อัปเดตคำตอบสำหรับแต่ละช่วงแล้ว |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
DataFilterValueRange
ช่วงของค่าที่ DataFilter
ระบุสถานที่ตั้ง
การแสดง JSON |
---|
{ "dataFilter": { object ( |
ช่อง | |
---|---|
dataFilter |
ตัวกรองข้อมูลที่อธิบายตำแหน่งของค่าในสเปรดชีต |
majorDimension |
มิติข้อมูลหลักของค่า |
values[] |
ข้อมูลที่จะเขียน ถ้าค่าที่ระบุเกินช่วงใดๆ ที่ตรงตามตัวกรองข้อมูล คำขอจะล้มเหลว หากค่าที่ระบุน้อยกว่าช่วงที่ตรงกัน ระบบจะเขียนเฉพาะค่าที่ระบุ ค่าที่มีอยู่ในช่วงที่ตรงกันจะไม่ได้รับผลกระทบ |
UpdateValuesByDataFilterResponse
คำตอบเมื่ออัปเดตช่วงของค่าโดยตัวกรองข้อมูลในสเปรดชีต
การแสดง JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
ช่อง | |
---|---|
updatedRange |
ช่วง (ในรูปแบบ A1) ที่ใช้การอัปเดต |
updatedRows |
จำนวนแถวที่มีการอัปเดตอย่างน้อย 1 เซลล์ในแถว |
updatedColumns |
จำนวนคอลัมน์ที่มีการอัปเดตอย่างน้อย 1 เซลล์ในคอลัมน์ |
updatedCells |
จำนวนเซลล์ที่อัปเดต |
dataFilter |
ตัวกรองข้อมูลที่เลือกช่วงที่ได้รับการอัปเดต |
updatedData |
ค่าของเซลล์ในช่วงที่ตรงกับ dataFilter หลังจากใช้การอัปเดตทั้งหมด โดยจะรวมเฉพาะในกรณีที่ช่อง |