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

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