- คำขอ 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 หลังจากนำการอัปเดตทั้งหมดไปใช้ โดยกรณีนี้จะเกิดขึ้นต่อเมื่อช่อง |