Method: spreadsheets.values.batchClear

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

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

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

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

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

JSON के काेड में दिखाना 
{
  "ranges": [
    string
  ]
}
फ़ील्ड
ranges[]

string

A1 नोटेशन या R1C1 नोटेशन में, मिटाई जाने वाली रेंज.

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

स्प्रेडशीट में वैल्यू की किसी रेंज को मिटाने पर मिलने वाला जवाब.

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

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

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