स्प्रेडशीट में कई शीट हो सकती हैं. साथ ही, हर शीट में पंक्तियों या कॉलम की संख्या जितनी चाहे उतनी हो सकती है. सेल, किसी पंक्ति और कॉलम के इंटरसेक्शन पर मौजूद जगह होती है. इसमें डेटा वैल्यू हो सकती है. 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 |
ROWS |
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
टेबल है (इसके बावजूद कि रेंज की शुरुआत और आखिर मेंB4:D6
टेबल नहीं है).
नीचे दिए गए range
इनपुट, B7
से लिखना शुरू नहीं करेंगे:
A1
,A3
से लिखना शुरू करेगा, क्योंकि यहA1:C2
टेबल में है.E4
,E4
से लिखना शुरू करेगा, क्योंकि यह किसी टेबल में नहीं है. (A4
भी इसी वजह सेA4
पर लिखना शुरू करेगा.)
इसके अलावा, आपके पास यह चुनने का विकल्प होता है कि आपको टेबल के बाद मौजूदा डेटा को ओवरराइट करना है या नए डेटा के लिए नई पंक्तियां डालनी हैं. डिफ़ॉल्ट रूप से, इनपुट टेबल के बाद मौजूद डेटा को ओवरराइट कर देता है. नया डेटा नई पंक्तियों में लिखने के लिए, InsertDataOption
का इस्तेमाल करें और insertDataOption=INSERT_ROWS
डालें.
Sheets में सेल और पंक्तियों की सीमाओं के बारे में ज़्यादा जानने के लिए, Google Drive में सेव की जा सकने वाली फ़ाइलें लेख पढ़ें.