Method: spreadsheets.values.clear

מחיקת ערכים מגיליון אלקטרוני. מבצע הקריאה החוזרת צריך לציין את המזהה והטווח של הגיליון האלקטרוני. רק הערכים נמחקים – כל שאר המאפיינים של התא (כמו עיצוב, אימות נתונים וכו') נשמרים.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
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

מידע נוסף זמין במדריך ההרשאות.