ล้างช่วงค่าอย่างน้อยหนึ่งช่วงจากสเปรดชีต ผู้โทรต้องระบุรหัสสเปรดชีตและ DataFilters
อย่างน้อย 1 รายการ ระบบจะล้างช่วงที่ตรงกับตัวกรองข้อมูลที่ระบุ ระบบจะล้างเฉพาะค่าเท่านั้น พร็อพเพอร์ตี้อื่นๆ ทั้งหมดของเซลล์ (เช่น การจัดรูปแบบ การตรวจสอบข้อมูล ฯลฯ) จะยังคงอยู่
คำขอ HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
spreadsheetId |
รหัสของสเปรดชีตที่จะอัปเดต |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{
"dataFilters": [
{
object ( |
ช่อง | |
---|---|
dataFilters[] |
|
เนื้อหาการตอบกลับ
การตอบกลับเมื่อล้างช่วงค่าที่เลือกด้วย DataFilters
ในสเปรดชีต
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
ช่อง | |
---|---|
spreadsheetId |
สเปรดชีตที่ใช้การอัปเดต |
clearedRanges[] |
ช่วงที่ถูกล้างไปแล้วในรูปแบบ A1 ถ้าคำขอเป็นคำขอสำหรับช่วงที่ไม่มีขอบเขตหรือช่วงที่มีค่ามากกว่าขอบเขตของชีต นี่คือช่วงจริงที่ถูกล้าง และจำกัดขอบเขตกับขีดจำกัดของชีต |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์