स्प्रेडशीट में, सेल में मौजूद वैल्यू डेटा के अलावा कई अन्य तरह का डेटा भी होता है. जैसे:
- डाइमेंशन
- सेल फ़ॉर्मैट और बॉर्डर
- नाम वाली रेंज
- सुरक्षित की गई रेंज
- कंडिशनल (शर्त के साथ) फ़ॉर्मैटिंग की सुविधा
इनमें से कुछ तरह के डेटा होते हैं, जो स्प्रेडशीट के दिखने और उसके दिखने के तरीके
को कंट्रोल करते हैं. spreadsheets.batchUpdate
वाले तरीके का इस्तेमाल करके,
इनमें से किसी भी स्प्रेडशीट की जानकारी को अपडेट किया जा सकता है. बदलावों को बैच में ग्रुप किया जाता है, ताकि
अगर एक अनुरोध पूरा न हो, तो कोई भी दूसरा अनुरोध (संभावित रूप से निर्भर) न लिखा जाए.
इस पेज पर spreadsheets.batchUpdate
तरीके का इस्तेमाल करने के बारे में बुनियादी जानकारी दी गई है. अगर आपको सेल की वैल्यू वाले डेटा को पढ़ने और लिखने की ज़रूरत है, तो सेल की वैल्यू पढ़ें और लिखें में दिए गए spreadsheets.values
संसाधन का इस्तेमाल भी किया जा सकता है.
कारोबार की कैटगरी
spreadsheets.batchUpdate
के साथ काम करने वाले खास ऑपरेशन को इन बड़ी कैटगरी में बांटा जा सकता है:
कैटगरी | ब्यौरा |
---|---|
जोड़ें (और डुप्लीकेट) | नए ऑब्जेक्ट जोड़ें (कभी-कभी पुराने ऑब्जेक्ट के आधार पर, जैसे कि डुप्लीकेट अनुरोध के लिए). |
अपडेट करें (और सेट करें) | किसी ऑब्जेक्ट की कुछ प्रॉपर्टी को अपडेट करें, आम तौर पर पुरानी प्रॉपर्टी को ही छोड़ दें (जबकि सेट अनुरोध पिछले डेटा की जगह ले लेता है). |
मिटाएं | ऑब्जेक्ट हटाएं. |
इन कैटगरी का इस्तेमाल अगले सेक्शन में, खास कार्रवाइयों के व्यवहार के बारे में बताने के लिए किया जाता है.
बैच अपडेट कार्रवाइयां
spreadsheets.batchUpdate
वाला तरीका, एक या उससे ज़्यादा अनुरोध ऑब्जेक्ट को लेकर काम करता है. हर ऑब्जेक्ट में, किसी एक तरह के अनुरोध के बारे में जानकारी होती है. अनुरोध कई तरह के
हो सकते हैं. यहां अलग-अलग कैटगरी में बांटे गए,
अनुरोधों के टाइप की जानकारी दी गई है.
कुछ और अनुरोध भी होते हैं जो डेटा में हेर-फेर करने के लिए, उपयोगकर्ता की कार्रवाइयों की नकल करते हैं:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
बाहर रखे गए प्लेसमेंट से जुड़ी सीमाएं
Google Sheets में सेल और पंक्ति की सीमाओं के बारे में ज़्यादा जानने के लिए, Google Drive में सेव की जा सकने वाली फ़ाइलें देखें.
फ़ील्ड मास्क
कई "अपडेट" अनुरोधों के लिए फ़ील्ड मास्क की ज़रूरत होती है. ये फ़ील्ड की कॉमा-डीलिमिटेड सूची हैं. इन्हें किसी ऑब्जेक्ट में सिर्फ़ कुछ फ़ील्ड को अपडेट किया जाता है, जबकि दूसरे फ़ील्ड में कोई बदलाव नहीं किया जाता. *
के फ़ील्ड मास्क को वाइल्डकार्ड की तरह माना जाता है. साथ ही, यह मैसेज में हर फ़ील्ड के बारे में बताने के लिए शॉर्टहैंड होता है (इसका मतलब है कि अगर अनुरोध में फ़ील्ड के लिए कोई वैल्यू तय नहीं की जाती है, तो वह अपनी डिफ़ॉल्ट स्थिति पर वापस आ सकती है).
फ़ील्ड मास्क के बारे में ज़्यादा जानकारी के लिए, फ़ील्ड मास्क इस्तेमाल करने का तरीका देखें.
नीचे दिए गए सैंपल में, सिर्फ़ स्प्रेडशीट का टाइटल अपडेट करने के लिए UpdateSpreadsheetPropertiesRequest
का इस्तेमाल किया जाता है:
अनुरोध:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
अनुरोध का मुख्य हिस्सा:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
TITLE को स्प्रेडशीट के नए शीर्षक से बदलें.
जवाब
स्प्रेडशीट को अपडेट करते समय, कुछ तरह के अनुरोधों पर जवाब दिख सकते हैं. इन्हें एक अरे में दिखाया जाता है, जहां हर रिस्पॉन्स का इंडेक्स वही होता है जो उससे जुड़े अनुरोध का इंडेक्स होता है. कुछ अनुरोधों के जवाब नहीं दिए जाते और उनके लिए जवाब खाली होता है.
आम तौर पर, "जोड़ें" अनुरोधों में ऐसे जवाब होते हैं जो जोड़े गए ऑब्जेक्ट की आईडी जैसी जानकारी देते हैं. इस्तेमाल किए जा सकने वाले जवाबों की सूची के लिए, जवाब देखें.
उदाहरण
यह कोड सैंपल ये कार्रवाइयां करता है:
title
वैरिएबल का इस्तेमाल करके, स्प्रेडशीट के टाइटल को अपडेट करता है.- यह फ़ंक्शन
find
औरreplacement
वैरिएबल का इस्तेमाल करके, स्प्रेडशीट में सेल की वैल्यू ढूंढता और उन्हें बदलता है.