Google Sheets API से आपको सेल, रेंज, रेंज के सेट, और पूरी शीट की वैल्यू पढ़ने की सुविधा मिलती है. इस पेज पर दिए गए उदाहरणों में, spreadsheets.values
संसाधन इस्तेमाल करके कुछ सामान्य रीड ऑपरेशन के बारे में बताया गया है. spreadsheets.get
तरीके का इस्तेमाल करके भी सेल की वैल्यू पढ़ी जा सकती हैं. हालांकि, आम तौर पर, spreadsheets.values.get
या spreadsheets.values.batchGet
को इस्तेमाल करना आसान होता है.
ये उदाहरण, न्यूट्रल भाषा में एचटीटीपी अनुरोधों के रूप में दिखाए जाते हैं. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, अलग-अलग भाषाओं में रीड लागू करने का तरीका जानने के लिए, सेल की वैल्यू पढ़ें और लिखें देखें.
इन उदाहरणों में SPREADSHEET_ID प्लेसहोल्डर से पता चलता है कि आप स्प्रेडशीट आईडी कहां देंगे. यह आईडी, स्प्रेडशीट के यूआरएल में देखा जा सकता है. जिन रेंज से पढ़ना है उन्हें अनुरोध के यूआरएल में A1 नोटेशन का इस्तेमाल करके बताया जाता है. उदाहरण के लिए, Sheets1!A1:D5 रेंज मौजूद है.
सोर्स डेटा
इन उदाहरणों के लिए, मान लें कि पढ़ी जा रही स्प्रेडशीट की पहली शीट ("Sheet1") में यह सोर्स डेटा मौजूद है. पहली पंक्ति में दिए गए स्ट्रिंग अलग-अलग कॉलम के लेबल होते हैं. अपनी स्प्रेडशीट में दूसरी शीट से पढ़ने के तरीके के उदाहरण देखने के लिए, A1 नोटेशन देखें.
जवाब | B | C | D | |
1 | आइटम | कीमत | स्टॉक में है | शिपिंग की तारीख |
2 | व्हील | 20.50 डॉलर | 4 | 1/3/2016 |
3 | दरवाज़ा | हॉन्ग कॉन्ग डॉलर | 2 | 15/3/2016 |
4 | इंजन | 100 डॉलर | 1 | 20/3/2016 |
5 | कुल योग | 135.5 डॉलर | 7 | 20/3/2016 |
किसी एक रेंज को पढ़ना
यहां दिया गया
spreadsheets.values.get
कोड सैंपल दिखाता है कि Sheets1!A1:D5 रेंज की वैल्यू को कैसे पढ़ा जाए और रिस्पॉन्स में उन्हें कैसे दिखाता है. पीछे की पंक्तियां और कॉलम खाली हैं.
अनुरोध का प्रोटोकॉल यहां दिखता है.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5
इस रिस्पॉन्स में एक ValueRange
ऑब्जेक्ट होता है, जो रेंज की वैल्यू के बारे में बताता है. majorDimension
फ़ील्ड से पता चलता है कि अरे, वैल्यू की सूचियां हैं जिन्हें पंक्तियों में व्यवस्थित किया गया है.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "3/1/2016"], ["Door", "$15", "2", "3/15/2016"], ["Engine", "$100", "1", "30/20/2016"], ["Totals", "$135.5", "7", "3/20/2016"] ], }
कॉलम के हिसाब से ग्रुप की गई सिर्फ़ एक रेंज को पढ़ना
यहां दिया गया
spreadsheets.values.get
कोड सैंपल दिखाता है कि Sheets1!A1:D3 रेंज की वैल्यू को कैसे पढ़ा जाए और रिस्पॉन्स में उन्हें
कॉलम के हिसाब से ग्रुप में कैसे दिखाता है. पीछे की खाली पंक्तियों और कॉलम को
मिटा दिया जाता है.
अनुरोध का प्रोटोकॉल यहां दिखता है.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS
इस रिस्पॉन्स में एक ValueRange
ऑब्जेक्ट होता है, जो रेंज की वैल्यू के बारे में बताता है. majorDimension
फ़ील्ड से पता चलता है कि अरे, कॉलम के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं.
{ "range": "Sheet1!A1:D3", "majorDimension": "COLUMNS", "values": [ ["Item", "Wheel", "Door"], ["Cost", "$20.50", "$15"], ["Stocked", "4", "2"], ["Ship Date", "3/1/2016", "3/15/2016"] ], }
रेंडरिंग के विकल्पों की मदद से, किसी एक रेंज को पढ़ना
यहां दिया गया
spreadsheets.values.get
कोड सैंपल दिखाता है कि Sheets1!A1:D5 रेंज की वैल्यू को कैसे पढ़ा जाए और रिस्पॉन्स में उन्हें कैसे
दिखता है. हालांकि, यह रेंडरिंग के विकल्पों का इस्तेमाल करके, यह मैनेज करता है कि
जानकारी कैसे दिखे. FORMULA
की ValueRenderOption
सेटिंग से पता चलता है कि कैलकुलेट की गई वैल्यू के बजाय, फ़ॉर्मूले दिखाए जाने हैं. वहीं, SERIAL_NUMBER
की DateTimeRenderOption
सेटिंग से पता चलता है कि तारीखों को संख्याओं के तौर पर दिखाया जाना है.
अन्य सेटिंग भी संभव हैं. पीछे की खाली पंक्तियों और कॉलम को
मिटा दिया जाता है.
अनुरोध का प्रोटोकॉल यहां दिखता है.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5? valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER
इस रिस्पॉन्स में एक ValueRange
ऑब्जेक्ट होता है, जो रेंज की वैल्यू के बारे में बताता है. majorDimension
फ़ील्ड से पता चलता है कि अरे, वैल्यू की सूचियां हैं जिन्हें पंक्तियों में व्यवस्थित किया गया है.
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "42430"], ["Door", "$15", "2", "42444"], ["Engine", "$100", "1", "42449"], ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"] ], }
एक से ज़्यादा रेंज पढ़ें
यहां दिया गया
spreadsheets.values.batchGet
कोड सैंपल दिखाता है कि Sheets1!B:B और Sheets1!D:D रेंज की वैल्यू को कैसे पढ़ा जा सकता है और रिस्पॉन्स के तौर पर
उन्हें दिखाता है. UNFORMATTED_VALUE
की ValueRenderOption
सेटिंग से पता चलता है कि वैल्यू को कैलकुलेट किया जाता है, लेकिन रिस्पॉन्स में उन्हें फ़ॉर्मैट नहीं किया जाता. पीछे की पंक्तियां और कॉलम खाली हैं.
अनुरोध का प्रोटोकॉल यहां दिखता है.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
इस मेथड कॉल के रिस्पॉन्स में स्प्रेडशीट आईडी वाला एक ऑब्जेक्ट और अनुरोध की गई हर रेंज से जुड़े ValueRange
ऑब्जेक्ट की कलेक्शन शामिल होता है. ये ऑब्जेक्ट, अनुरोध किए गए क्रम में दिखते हैं. majorDimension
फ़ील्ड से पता चलता है कि अरे, कॉलम के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं. उदाहरण के लिए:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!B1:B1000", "majorDimension": "COLUMNS", "values": [ ["Cost",20.5,15,100,135.5] ] }, { "range": "Sheet1!D1:D1000", "majorDimension": "COLUMNS", "values": [ ["Ship Date",42430,42444,42449,42449] ]s } ] }
एक से ज़्यादा शीट में, एक से ज़्यादा रेंज पढ़ना
यहां दिया गया
spreadsheets.values.batchGet
कोड सैंपल से पता चलता है कि Sheets1!A1:D5,
Products!D1:D100, और Sales!E4:F6 में मौजूद रेंज की वैल्यू को कैसे पढ़ा जा सकता है और जवाब देने के बाद ये वैल्यू दिखाता है. UNFORMATTED_VALUE
की ValueRenderOption
सेटिंग से पता चलता है कि वैल्यू को कैलकुलेट किया जाता है, लेकिन रिस्पॉन्स में उन्हें फ़ॉर्मैट नहीं किया जाता. पीछे की पंक्तियां और कॉलम खाली हैं.
अनुरोध का प्रोटोकॉल यहां दिखता है.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet? ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS
इस मेथड कॉल के रिस्पॉन्स में स्प्रेडशीट आईडी वाला एक ऑब्जेक्ट और अनुरोध की गई हर रेंज से जुड़े ValueRange
ऑब्जेक्ट की कलेक्शन शामिल होता है. ये ऑब्जेक्ट, अनुरोध किए गए क्रम में दिखते हैं. majorDimension
फ़ील्ड से पता चलता है कि अरे, कॉलम के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं. उदाहरण के लिए:
{ "spreadsheetId": SPREADSHEET_ID, "valueRanges": [ { "range": "Sheet1!A1:D5", "majorDimension": "COLUMNS", "values": [ [...], [...] ] }, { "range": "Products!D1:D100", "majorDimension": "COLUMNS", "values": [ [...] ] }, { "range": "Sales!E4:F6", "majorDimension": "COLUMNS", "values": [ [...], [...] ] } ] }