Method: spreadsheets.values.batchClear

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

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

เนื้อหาของคำขอ

เนื้อหาของคําขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

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

string

ช่วงที่จะล้างในรูปแบบ A1 หรือ R1C1

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

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

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

การแสดง 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

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์