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