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