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