स्प्रेडशीट में कई शीट हो सकती हैं. इनमें हर शीट में अनगिनत पंक्तियां होती हैं
कॉलम का इस्तेमाल करें. सेल उस जगह को कहते हैं जो
किसी पंक्ति और कॉलम के इंटरसेक्शन में शामिल किया गया हो. साथ ही, इसमें डेटा की वैल्यू भी शामिल हो सकती है. कॉन्टेंट बनाने
Google Sheets API,
spreadsheets.values
वैल्यू को पढ़ने और लिखने में मदद करने वाले संसाधन.
इस पेज पर, spreadsheets.values
संसाधन को इस्तेमाल करने के बारे में बुनियादी बातें बताई गई हैं. अगर आपने
आपको कोड में पंक्तियां या फ़ॉर्मेटिंग और अन्य प्रॉपर्टी अपडेट करनी होंगी
शीट में, आपको
spreadsheets.batchUpdate
तरीका है जो स्प्रेडशीट अपडेट करें में बताया गया है.
तरीके
spreadsheets.values
संसाधन
मानों को पढ़ने और लिखने के लिए नीचे दिए गए तरीके देता है, जिनमें से हर एक
चुनिंदा टास्क:
रेंज का ऐक्सेस | पढ़ना | लेखन |
---|---|---|
एक रेंज | spreadsheets.values.get |
spreadsheets.values.update |
एक से ज़्यादा रेंज | spreadsheets.values.batchGet |
spreadsheets.values.batchUpdate |
जोड़ा जा रहा है | spreadsheets.values.append |
आम तौर पर, एक से ज़्यादा लेख या अपडेट को
batchGet
और batchUpdate
तरीकों का इस्तेमाल किया जाता है. आम तौर पर, ऐसा करने से यह बेहतर होता है
क्षमता.
इनमें से हर एक तरीके के उदाहरण देखने के लिए, बेसिक रीडिंग और बेसिक लेखन के सैंपल पेज. सभी सैंपल देखने के लिए, इसे देखें सैंपल की खास जानकारी देने वाले पेज पर जाएं.
पढ़ें
शीट में मौजूद डेटा की वैल्यू पढ़ने के लिए, आपके पास स्प्रेडशीट आईडी और A1 होना ज़रूरी है
नोटेशन का इस्तेमाल करें. शीट आईडी (A1:B2
) के बिना रेंज तय की जा रही है
इसका मतलब है कि अनुरोध, स्प्रेडशीट में पहली शीट पर लागू होता है. ज़्यादा के लिए
स्प्रेडशीट आईडी और A1 नोटेशन की जानकारी पाने के लिए, Google Sheets API का इस्तेमाल करें
खास जानकारी.
कई वैकल्पिक क्वेरी पैरामीटर आउटपुट के फ़ॉर्मैट को कंट्रोल करते हैं:
फ़ॉर्मैट पैरामीटर | डिफ़ॉल्ट मान |
---|---|
majorDimension |
पंक्तियां |
valueRenderOption |
FORMATTED_VALUE |
dateTimeRenderOption |
SERIAL_NUMBER |
ध्यान दें कि आपको dateTimeRenderOption
का इस्तेमाल सिर्फ़ तब करना चाहिए, जब valueRenderOption
FORMATTED_VALUE
नहीं है.
वापस किए जाने वाले डेटा की मात्रा के लिए कोई स्पष्ट सीमा नहीं है. गड़बड़ियां मिलने पर कोई डेटा नहीं मिलता. पीछे वाली खाली पंक्तियों और कॉलम को छोड़ दिया जाता है.
एकवचन और बैच पाने के तरीकों के बारे में नीचे बताया गया है. बेसिक के सैंपल के लिए पढ़ने की कार्रवाइयां, बुनियादी तरीके से पढ़ने की सुविधा देखें.
कोई एक रेंज पढ़ना
किसी स्प्रेडशीट से वैल्यू की एक रेंज पढ़ने के लिए,
spreadsheets.values.get
अनुरोध:
Apps Script
Java
JavaScript
Node.js
PHP
Python
Ruby
इस अनुरोध की प्रतिक्रिया इस तरह दी जाती है:
ValueRange
ऑब्जेक्ट है.
एक से ज़्यादा रेंज के बारे में जानें
किसी स्प्रेडशीट से वैल्यू की अलग-अलग रेंज को पढ़ने के लिए,
spreadsheets.values.batchGet
अनुरोध है, जिसकी मदद से आप वापस पाने के लिए कई रेंज तय कर सकते हैं:
Apps Script
Java
JavaScript
Node.js
PHP
Python
Ruby
इस अनुरोध की प्रतिक्रिया इस तरह दी जाती है:
BatchGetValuesResponse
वह ऑब्जेक्ट जिसमें spreadsheetId
और
ValueRange
ऑब्जेक्ट हैं.
लिखें
किसी शीट में लिखने के लिए, आपको स्प्रेडशीट आईडी की ज़रूरत होगी. यह आईडी A1 में मौजूद सेल की रेंज होती है नोटेशन और डेटा जिसे आप अनुरोध के उचित निकाय में लिखना चाहते हैं ऑब्जेक्ट है. स्प्रेडशीट आईडी और A1 नोटेशन के बारे में ज़्यादा जानकारी के लिए, Google Sheets API की खास जानकारी.
अपडेट के लिए, मान्य वैल्यू सबमिट करना ज़रूरी है
ValueInputOption
पैरामीटर.
सिर्फ़ एक बार में अपडेट करने के लिए, यह एक ज़रूरी क्वेरी पैरामीटर है. बैच अपडेट के लिए,
अनुरोध के मुख्य हिस्से में यह पैरामीटर होना ज़रूरी है. ValueInputOption
के कंट्रोल
इनपुट डेटा की व्याख्या कैसे की जानी चाहिए और इनपुट स्ट्रिंग पार्स की गई हैं या नहीं या
नहीं, जैसा कि नीचे दी गई टेबल में बताया गया है:
ValueInputOption |
ब्यौरा |
---|---|
RAW |
इनपुट को पार्स नहीं किया गया है और उसे स्ट्रिंग के तौर पर डाला गया है. उदाहरण के लिए, इनपुट "=1+2" स्ट्रिंग को डालता है, फ़ॉर्मूला नहीं, "=1+2" डालें. (बूलियन या संख्याओं जैसे नॉन-स्ट्रिंग वैल्यू को हमेशा RAW के तौर पर मैनेज किया जाता है.) |
USER_ENTERED |
इनपुट को ठीक वैसे ही पार्स किया जाता है, जैसे उसे Sheets के यूज़र इंटरफ़ेस (यूआई) में डाला गया हो. उदाहरण के लिए, "1 मार्च 2016" एक तारीख बन जाता है, और "=1+2" एक फ़ॉर्मूला बन जाता है. फ़ॉर्मैट का अनुमान भी लगाया जा सकता है, इसलिए "$100.15" मुद्रा फ़ॉर्मेटिंग के साथ संख्या बन जाती है. |
एकवचन और बैच अपडेट करने के तरीकों के बारे में नीचे बताया गया है. बेसिक के सैंपल के लिए लिखने के तरीके, सामान्य लेखन देखें.
किसी एक रेंज में लिखें
किसी एक रेंज में डेटा लिखने के लिए,
spreadsheets.values.update
अनुरोध:
Apps Script
Java
JavaScript
Node.js
PHP
Python
Ruby
अपडेट करने के अनुरोध का मुख्य हिस्सा
ValueRange
ऑब्जेक्ट है, हालांकि सिर्फ़ values
ही ज़रूरी फ़ील्ड है. अगर range
बताया गया है, तो यह
यूआरएल की रेंज से मेल खाना चाहिए. ValueRange
में, विकल्प के तौर पर यह बताया जा सकता है
यह
majorDimension
.
डिफ़ॉल्ट रूप से, ROWS
का इस्तेमाल किया जाता है. अगर COLUMNS
तय किया गया है, तो हर अंदरूनी अरे
पंक्ति के बजाय कॉलम पर लिखा जाता है.
अपडेट करते समय, बिना डेटा वाली वैल्यू को स्किप कर दिया जाता है. डेटा मिटाने के लिए, खाली सेल का इस्तेमाल करें स्ट्रिंग ("").
एक से ज़्यादा रेंज लिखें
अगर आपको एक से ज़्यादा ऐसी रेंज लिखनी हैं जो एक जैसी नहीं हैं, तो
spreadsheets.values.batchUpdate
अनुरोध:
Apps Script
Java
JavaScript
Node.js
PHP
Python
Ruby
बैच अपडेट करने के अनुरोध का मुख्य हिस्सा
BatchUpdateValuesRequest
ऑब्जेक्ट है, जिसमें एक ValueInputOption
और
ValueRange
ऑब्जेक्ट (हर लिखित रेंज के लिए एक). हर ValueRange
ऑब्जेक्ट अपना खुद का ऑब्जेक्ट बताता है
range
, majorDimension
, और इनपुट डेटा.
वैल्यू जोड़ें
शीट में डेटा टेबल के बाद डेटा जोड़ने के लिए,
spreadsheets.values.append
अनुरोध:
Apps Script
Java
JavaScript
Node.js
PHP
Python
Ruby
अपडेट करने के अनुरोध का मुख्य हिस्सा
ValueRange
ऑब्जेक्ट है, हालांकि सिर्फ़ values
ही ज़रूरी फ़ील्ड है. अगर range
बताया गया है, तो यह
यूआरएल की रेंज से मेल खाना चाहिए. ValueRange
में, विकल्प के तौर पर यह बताया जा सकता है
यह
majorDimension
.
डिफ़ॉल्ट रूप से, ROWS
का इस्तेमाल किया जाता है. अगर COLUMNS
तय किया गया है, तो हर अंदरूनी अरे
पंक्ति के बजाय कॉलम पर लिखा जाता है.
इनपुट रेंज का इस्तेमाल, मौजूदा डेटा को खोजने और "टेबल" ढूंढने के लिए किया जाता है इसके अंदर
उस सीमा को चुनें. टेबल की अगली लाइन में वैल्यू जोड़ दी जाती हैं. इसकी शुरुआत
टेबल के पहले कॉलम में जोड़ें. उदाहरण के लिए, Sheet1
देखें, जो ऐसा दिखता है:
A | B | C | D | E | |
1 | x | y | z | ||
2 | x | y | z | ||
3 | |||||
4 | x | y | |||
5 | y | z | |||
6 | x | y | z | ||
7 |
शीट में दो टेबल हैं: A1:C2
और B4:D6
. जोड़े गए मान यह कर पाएंगे
नीचे दिए गए सभी range
इनपुट के लिए, B7
से शुरू होते हैं:
Sheet1
क्योंकि यह शीट के सभी डेटा की जांच करेगा और किB4:D6
पर मौजूद टेबल आखिरी टेबल है.B4
याC5:D5
, क्योंकि वे दोनोंB4:D6
टेबल में हैं.B2:D4
, क्योंकि रेंज में आखिरी टेबलB4:D6
है (इसमेंA1:C2
टेबल भी शामिल है).A3:G10
, क्योंकि रेंज में आखिरी टेबलB4:D6
है (भले ही, वह पहले से शुरू हो और बाद में खत्म हो).
ये range
इनपुट B7
पर लिखना शुरू नहीं होंगे:
A1
,A3
पर लिखना शुरू करेगा, क्योंकि यहA1:C2
टेबल में है.E4
,E4
पर लिखना शुरू करेगा, क्योंकि यह किसी भी टेबल में नहीं है. (इन वजहों सेA4
भीA4
पर लिखना शुरू करेगा.)
इसके अलावा, आपके पास यह चुनने की सुविधा होती है कि आप
टेबल या नए डेटा के लिए नई पंक्तियां शामिल करें. डिफ़ॉल्ट रूप से, इनपुट डेटा को बदल देता है
टेबल के बाद. नए डेटा को नई पंक्तियों में लिखने के लिए,
InsertDataOption
और insertDataOption=INSERT_ROWS
तय करें.
Sheets में सेल और पंक्ति की सीमाओं के बारे में ज़्यादा जानने के लिए, यहां देखें ऐसी फ़ाइलें जिन्हें Google Drive में सेव किया जा सकता है.