- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- इसे आज़माएं!
स्प्रेडशीट की एक या उससे ज़्यादा रेंज में वैल्यू सेट करता है. कॉलर को स्प्रेडशीट आईडी, valueInputOption
, और एक या उससे ज़्यादा DataFilterValueRanges
की जानकारी देनी होगी.
एचटीटीपी अनुरोध
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
spreadsheetId |
अपडेट करने के लिए स्प्रेडशीट का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "valueInputOption": enum ( |
फ़ील्ड | |
---|---|
valueInputOption |
इनपुट डेटा को किस तरह इंटरप्रेट किया जाना चाहिए. |
data[] |
स्प्रेडशीट पर लागू करने के लिए नई वैल्यू. अगर बताए गए |
includeValuesInResponse |
इससे तय होता है कि अपडेट रिस्पॉन्स में अपडेट की गई सेल की वैल्यू शामिल होनी चाहिए या नहीं. डिफ़ॉल्ट रूप से, जवाबों में अपडेट की गई वैल्यू शामिल नहीं होती हैं. हर |
responseValueRenderOption |
इससे तय होता है कि रिस्पॉन्स में वैल्यू कैसे रेंडर की जानी चाहिए. रेंडर करने का डिफ़ॉल्ट विकल्प |
responseDateTimeRenderOption |
इससे तय होता है कि रिस्पॉन्स में मौजूद तारीख, समय, और कुल समय को कैसे रेंडर किया जाए. अगर |
जवाब का मुख्य भाग
किसी स्प्रेडशीट में वैल्यू की रेंज अपडेट करते समय मिलने वाला रिस्पॉन्स.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
फ़ील्ड | |
---|---|
spreadsheetId |
वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे. |
totalUpdatedRows |
उन पंक्तियों की कुल संख्या जिनमें पंक्ति में कम से कम एक सेल अपडेट की गई थी. |
totalUpdatedColumns |
उन कॉलम की कुल संख्या जहां कॉलम में कम से कम एक सेल अपडेट की गई थी. |
totalUpdatedCells |
अपडेट की गई सेल की कुल संख्या. |
totalUpdatedSheets |
उन शीट की कुल संख्या जिनमें शीट में कम से कम एक सेल अपडेट की गई थी. |
responses[] |
हर रेंज के लिए जवाब अपडेट किया गया. |
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
DataFilterValueRange
उन मानों की श्रेणी जिनकी जगह को DataFilter
के ज़रिए तय किया जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "dataFilter": { object ( |
फ़ील्ड | |
---|---|
dataFilter |
स्प्रेडशीट में वैल्यू की जगह बताने वाला डेटा फ़िल्टर. |
majorDimension |
वैल्यू का मुख्य डाइमेंशन. |
values[] |
लिखा जाने वाला डेटा. अगर दी गई वैल्यू, डेटा फ़िल्टर से मैच होने वाली किसी भी रेंज से ज़्यादा है, तो अनुरोध स्वीकार नहीं किया जा सकता. अगर दी गई वैल्यू, मैच होने वाली रेंज से कम हैं और सिर्फ़ तय की गई वैल्यू लिखी गई हैं, तो मैच करने वाली रेंज में मौजूद वैल्यू पर कोई असर नहीं पड़ेगा. |
UpdateValuesByDataFilterResponse
स्प्रेडशीट में डेटा फ़िल्टर की मदद से, वैल्यू की रेंज अपडेट करने पर मिलने वाला रिस्पॉन्स.
जेएसओएन के काेड में दिखाना |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
फ़ील्ड | |
---|---|
updatedRange |
वह रेंज (A1 नोटेशन में) जिस पर अपडेट लागू किए गए थे. |
updatedRows |
उन पंक्तियों की संख्या जिनमें पंक्ति में कम से कम एक सेल अपडेट की गई थी. |
updatedColumns |
उन कॉलम की संख्या जिनमें कॉलम में कम से कम एक सेल अपडेट की गई थी. |
updatedCells |
अपडेट की गई सेल की संख्या. |
dataFilter |
वह डेटा फ़िल्टर जिसने अपडेट की गई रेंज को चुना है. |
updatedData |
सभी अपडेट लागू होने के बाद, चुनी गई रेंज में मौजूद सेल की वैल्यू, dataFilter से मेल खाती हैं. इसे सिर्फ़ तब शामिल किया जाता है, जब अनुरोध का |