Method: spreadsheets.values.batchClearByDataFilter

स्प्रेडशीट से वैल्यू की एक या उससे ज़्यादा रेंज हटा देता है. कॉलर को स्प्रेडशीट आईडी और एक या उससे ज़्यादा DataFilters की जानकारी देनी होगी. तय किए गए किसी भी डेटा फ़िल्टर से मिलती-जुलती रेंज मिटा दी जाएंगी. सिर्फ़ वैल्यू मिटाई जाती हैं -- सेल की अन्य सभी प्रॉपर्टी (जैसे, फ़ॉर्मैटिंग, डेटा की पुष्टि वगैरह) सेव रखी जाती हैं.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
spreadsheetId

string

अपडेट करने के लिए स्प्रेडशीट का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
फ़ील्ड
dataFilters[]

object (DataFilter)

DataFilters का इस्तेमाल करके यह तय किया जाता है कि किन रेंज को मिटाना है.

जवाब का मुख्य भाग

किसी स्प्रेडशीट में DataFilters की मदद से चुनी गई वैल्यू की रेंज मिटाते समय मिलने वाला रिस्पॉन्स.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.