Method: spreadsheets.values.batchClearByDataFilter

यह फ़ंक्शन, स्प्रेडशीट की एक या उससे ज़्यादा रेंज की वैल्यू मिटाता है. ज़्यादा जानकारी के लिए, मेटाडेटा को पढ़ना, लिखना, और खोजना लेख पढ़ें.

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

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

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

यह यूआरएल, 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

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