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

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

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

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

सोर्स डेटा

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

A B C D
1 आइटम लागत स्टॉक में है भेजने की तारीख
2 पहिया 20.50 डॉलर 4 1/3/2016
3 दरवाज़ा $15 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 और रिटर्न रेंज से वैल्यू को पढ़ने का तरीका बताता है लेकिन रेंडरिंग के विकल्पों का इस्तेमाल करके, वापस किया जाता है. कॉन्टेंट बनाने ValueRenderOption सेटिंग FORMULA का मतलब है कि फ़ॉर्मूला के लिए कैलकुलेट की गई वैल्यू और DateTimeRenderOption SERIAL_NUMBER की सेटिंग से पता चलता है कि तारीखों को नंबर के तौर पर दिखाया जाना है. इसके अलावा, अन्य सेटिंग का इस्तेमाल भी किया जा सकता है. पिछली पंक्तियां और कॉलम खाली हैं छोड़ा गया.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

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 और Sheet1!D:D रेंज से वैल्यू पढ़ने का तरीका बताता है जवाब में इन्हें नतीजे के तौर पर दिखाता है. कॉन्टेंट बनाने ValueRenderOption सेटिंग UNFORMATTED_VALUE का मतलब है कि वैल्यू कैलकुलेट की गई हैं. इन्हें फ़ॉर्मैट नहीं किया गया है डालें. पीछे वाली खाली पंक्तियों और कॉलम को छोड़ दिया जाता है.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

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 में, रेंज से वैल्यू कैसे पढ़ें, प्रॉडक्ट!D1:D100, और Sales!E4:F6. ये जवाब में उन्हें नतीजे के तौर पर दिखाते हैं. कॉन्टेंट बनाने ValueRenderOption सेटिंग UNFORMATTED_VALUE का मतलब है कि वैल्यू कैलकुलेट की गई हैं. इन्हें फ़ॉर्मैट नहीं किया गया है डालें. पीछे वाली खाली पंक्तियों और कॉलम को छोड़ दिया जाता है.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

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": [
        [...],
        [...]
      ]
    }
  ]
}