सेल में मौजूद वैल्यू डेटा के अलावा, स्प्रेडशीट में कई अन्य तरह का डेटा भी शामिल होता है. जैसे:
- आयाम
- सेल के फ़ॉर्मैट और बॉर्डर
- नाम वाली रेंज
- सुरक्षित की गई रेंज
- कंडिशनल यानी शर्त के साथ फ़ॉर्मैटिंग की सुविधा
ये ऐसे कई तरह के डेटा में से कुछ हैं जो स्प्रेडशीट के दिखने के तरीके और उसके काम करने के तरीके को कंट्रोल करते हैं. spreadsheets.batchUpdate तरीके से, स्प्रेडशीट की इनमें से किसी भी जानकारी को अपडेट किया जा सकता है. बदलावों को एक बैच में ग्रुप किया जाता है, ताकि अगर एक अनुरोध पूरा न हो, तो अन्य (संभावित रूप से निर्भर) बदलाव न लिखे जाएं.
इस पेज पर, spreadsheets.batchUpdate तरीके के इस्तेमाल के बारे में बुनियादी जानकारी दी गई है. अगर आपको सेल वैल्यू डेटा को पढ़ना और लिखना है, तो spreadsheets.values रिसॉर्स का इस्तेमाल किया जा सकता है. इसके बारे में सेल वैल्यू पढ़ना और लिखना में बताया गया है.
कारोबार की कैटगरी
spreadsheets.batchUpdate के साथ काम करने वाली कार्रवाइयों को इन कैटगरी में बांटा जा सकता है:
| कैटगरी | ब्यौरा |
|---|---|
| जोड़ें (और डुप्लीकेट बनाएं) | नए ऑब्जेक्ट जोड़ना. कभी-कभी, ये ऑब्जेक्ट पुराने ऑब्जेक्ट पर आधारित होते हैं. जैसे, डुप्लीकेट अनुरोधों में. |
| अपडेट करें (और सेट करें) | किसी ऑब्जेक्ट की कुछ प्रॉपर्टी अपडेट करता है. आम तौर पर, पुरानी प्रॉपर्टी को नहीं बदलता. वहीं, सेट करने का अनुरोध करने पर, पुराना डेटा बदल जाता है. |
| मिटाएं | ऑब्जेक्ट हटाएं. |
इन कैटगरी का इस्तेमाल अगले सेक्शन में, कुछ खास कार्रवाइयों के व्यवहार के बारे में बताने के लिए किया गया है.
बैच अपडेट करने की कार्रवाइयां
spreadsheets.batchUpdate तरीके में, एक या उससे ज़्यादा Request ऑब्जेक्ट लिए जाते हैं. इनमें से हर ऑब्जेक्ट, कार्रवाई करने के लिए एक तरह के अनुरोध के बारे में बताता है. कई तरह के अनुरोध किए जा सकते हैं. यहां अलग-अलग कैटगरी में ग्रुप किए गए अनुरोधों के टाइप के बारे में जानकारी दी गई है.
इसके अलावा, कुछ और अनुरोध भी होते हैं जो डेटा में बदलाव करने के लिए, उपयोगकर्ता की कार्रवाइयों की नकल करते हैं:
- 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वैरिएबल का इस्तेमाल करके, स्प्रेडशीट में सेल की वैल्यू ढूंढता है और उन्हें बदलता है.