Method: spreadsheets.values.batchClearByDataFilter

מנקה טווח אחד או יותר של ערכים מגיליון אלקטרוני. המתקשר חייב לציין את מזהה הגיליון האלקטרוני ולפחות DataFilters. טווחים שתואמים לאחד ממסנני הנתונים שצוינו ינוקו. רק הערכים נמחקים – כל שאר המאפיינים של התא (למשל עיצוב, אימות נתונים וכו') נשמרים.

בקשת HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter

כתובת ה-URL כוללת תחביר של קידוד gRPC.

פרמטרים של נתיב

פרמטרים
spreadsheetId

string

המזהה של הגיליון האלקטרוני לעדכון.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
שדות
dataFilters[]

object (DataFilter)

ה-DataFilters משמש לקביעת הטווחים שיש לנקות.

גוף התשובה

התגובה כשמנקים טווח ערכים שנבחר באמצעות DataFilters בגיליון אלקטרוני.

אם התגובה הצליחה, גוף התגובה מכיל נתונים עם המבנה הבא:

ייצוג JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
שדות
spreadsheetId

string

הגיליון האלקטרוני שעליו הוחלו העדכונים.
clearedRanges[]

string

הטווחים שנמחקו, בסימון A1. אם הבקשות הן של טווח לא תוחם או של טווח שחורג מגבולות הגיליון, זהו הטווחים שנמחקו בפועל, והם חורגים מהמגבלות של הגיליון.

היקפי הרשאה

מחייב אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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