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