Method: spreadsheets.values.clear

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

คำขอ HTTP

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

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

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

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

string

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

string

ค่าหมายเหตุ A1 หรือ R1C1 ของค่าที่จะล้าง

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

เนื้อหาของคำขอต้องว่างเปล่า

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

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

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

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

string

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

string

ช่วง (ในระบบหมายเหตุ A1) ที่มีการล้าง (หากเป็นคําขอสําหรับช่วงที่ไม่มีขอบเขตหรือช่วงขนาดที่ใหญ่กว่าขอบเขตของแผ่นงาน ช่วงนี้จะเป็นช่วงวันที่จริงซึ่งถูกล้างข้อมูลและจํากัดไว้ที่ขีดจํากัดของแผ่นงาน)

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

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

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

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