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