बुनियादी जानकारी

Google Sheets API की मदद से, सेल, रेंज, रेंज के सेट, और पूरी शीट से वैल्यू पढ़ी जा सकती हैं. इस पेज पर दिए गए उदाहरणों में, spreadsheets.values रिसॉर्स के साथ किए जाने वाले कुछ सामान्य रीड ऑपरेशन के बारे में बताया गया है. spreadsheets.get तरीके का इस्तेमाल करके भी सेल की वैल्यू पढ़ी जा सकती हैं. हालांकि, आम तौर पर spreadsheets.values.get या spreadsheets.values.batchGet का इस्तेमाल करना ज़्यादा आसान होता है.

इन उदाहरणों को एचटीटीपी अनुरोधों के तौर पर दिखाया गया है, ताकि ये किसी भाषा पर आधारित न हों. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, अलग-अलग भाषाओं में पढ़ने की सुविधा लागू करने का तरीका जानने के लिए, सेल की वैल्यू पढ़ना और लिखना लेख पढ़ें.

इन उदाहरणों में, प्लेसहोल्डर SPREADSHEET_ID से पता चलता है कि आपको स्प्रेडशीट आईडी कहां डालना है. यह आईडी, स्प्रेडशीट के यूआरएल से पता लगाया जा सकता है. अनुरोध के यूआरएल में, A1 नोटेशन का इस्तेमाल करके, उन रेंज के बारे में बताया जाता है जिनसे डेटा पढ़ना है. उदाहरण के लिए, रेंज Sheet1!A1:D5 है.

सोर्स डेटा

इन उदाहरणों के लिए, मान लें कि जिस स्प्रेडशीट को पढ़ा जा रहा है उसकी पहली शीट ("Sheet1") में यह सोर्स डेटा मौजूद है. पहली लाइन में मौजूद स्ट्रिंग, अलग-अलग कॉलम के लिए लेबल होती हैं. अपनी स्प्रेडशीट में, दूसरी शीट से डेटा पढ़ने के उदाहरण देखने के लिए, A1 नोटेशन देखें.

किसी एक रेंज को पढ़ना

यहां दिए गए spreadsheets.values.get कोड के सैंपल में दिखाया गया है कि Sheet1!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 कोड के सैंपल में दिखाया गया है कि Sheet1!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 कोड के सैंपल में, Sheet1!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 कोड के सैंपल में दिखाया गया है कि Sheet1!B:B और Sheet1!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 कोड के उदाहरण में दिखाया गया है कि Sheet1!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": [
        [...],
        [...]
      ]
    }
  ]
}