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

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