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