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