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