Method: spreadsheets.values.clear

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

בקשת HTTP

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

כתובת ה-URL כוללת תחביר של קידוד 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

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