ניקוי הערכים מגיליון אלקטרוני. מבצע הקריאה החוזרת צריך לציין את המזהה והטווח של הגיליון האלקטרוני. רק הערכים נמחקים. כל שאר המאפיינים של התא (כגון עיצוב, אימות נתונים וכו') נשמרים.
בקשת HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
spreadsheetId |
מזהה הגיליון האלקטרוני שיש לעדכן. |
range |
סימון A1 או סימון R1C1 של הערכים שיש להסיר. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
התגובה בעת ניקוי טווח של ערכים בגיליון אלקטרוני.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "spreadsheetId": string, "clearedRange": string } |
שדות | |
---|---|
spreadsheetId |
הגיליון האלקטרוני שעליו בוצעו העדכונים. |
clearedRange |
הטווח (בסימון A1) שהוסר. (אם הבקשה הייתה לטווח לא מוגבל או לטווח שגדול מגבולות הגיליון, זה יהיה הטווח שנוקה בפועל ומוגבל למגבלות של הגיליון). |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
למידע נוסף, עיינו במדריך ההרשאות.