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