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

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