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

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