Method: spreadsheets.values.batchClear

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

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

उस स्प्रेडशीट का आईडी जिसे अपडेट करना है.

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

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

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

string

A1 नोटेशन या R1C1 नोटेशन में साफ़ की जाने वाली रेंज.

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

किसी स्प्रेडशीट में वैल्यू की रेंज साफ़ करते समय दिया गया जवाब.

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

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

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