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

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