Method: spreadsheets.values.batchClearByDataFilter

ล้างค่าในช่วงอย่างน้อย 1 ช่วงจากสเปรดชีต ดูข้อมูลเพิ่มเติมได้ที่อ่าน เขียน และค้นหาข้อมูลเมตา

ผู้โทรต้องระบุรหัสสเปรดชีตและ DataFilters อย่างน้อย 1 รายการ ระบบจะล้างช่วงที่ตรงกับตัวกรองข้อมูลที่ระบุ ระบบจะล้างเฉพาะค่าเท่านั้น ส่วนคุณสมบัติอื่นๆ ทั้งหมดของเซลล์ (เช่น การจัดรูปแบบ การตรวจสอบข้อมูล ฯลฯ) จะยังคงอยู่

คำขอ HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
spreadsheetId

string

รหัสของสเปรดชีตที่จะอัปเดต

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
ช่อง
dataFilters[]

object (DataFilter)

DataFilters ที่ใช้เพื่อกำหนดช่วงที่จะล้าง

เนื้อหาการตอบกลับ

การตอบสนองเมื่อล้างช่วงของค่าที่เลือกด้วย DataFilters ในสเปรดชีต

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
ช่อง
spreadsheetId

string

สเปรดชีตที่ใช้การอัปเดต
clearedRanges[]

string

ช่วงที่ล้างแล้วในรูปแบบ A1 หากคำขอเป็นช่วงที่ไม่มีขอบเขตหรือช่วงที่ใหญ่กว่าขอบเขตของชีต นี่คือช่วงจริงที่ถูกล้าง โดยมีขอบเขตตามขีดจำกัดของชีต

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์