Method: spreadsheets.values.batchGet

स्प्रेडशीट से वैल्यू की एक या उससे ज़्यादा रेंज दिखाता है. कॉल करने वाले को स्प्रेडशीट आईडी और एक या उससे ज़्यादा रेंज बतानी होंगी.

एचटीटीपी अनुरोध

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

उस स्प्रेडशीट का आईडी जिससे डेटा वापस पाना है.

क्वेरी पैरामीटर

पैरामीटर
ranges[]

string

वैल्यू पाने के लिए, रेंज का A1 नोटेशन या R1C1 नोटेशन.
majorDimension

enum (Dimension)

नतीजों के लिए इस्तेमाल किया जाने वाला मुख्य डाइमेंशन.

उदाहरण के लिए, अगर स्प्रेडशीट का डेटा: A1=1,B1=2,A2=3,B2=4 है, तो ranges=["A1:B2"],majorDimension=ROWS का अनुरोध करने पर [[1,2],[3,4]] दिखता है. वहीं, ranges=["A1:B2"],majorDimension=COLUMNS का अनुरोध करने पर [[1,3],[2,4]] दिखता है.
valueRenderOption

enum (ValueRenderOption)

आउटपुट में वैल्यू को कैसे दिखाया जाना चाहिए. रेंडर करने का डिफ़ॉल्ट विकल्प ValueRenderOption.FORMATTED_VALUE है.
dateTimeRenderOption

enum (DateTimeRenderOption)

आउटपुट में तारीखों, समयों, और अवधियों को कैसे दिखाया जाना चाहिए. अगर valueRenderOption FORMATTED_VALUE है, तो इसे अनदेखा कर दिया जाता है. dateTime के लिए रेंडर करने का डिफ़ॉल्ट विकल्प SERIAL_NUMBER है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

स्प्रेडशीट में वैल्यू की एक से ज़्यादा रेंज को वापस लाने पर मिलने वाला रिस्पॉन्स.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
फ़ील्ड
spreadsheetId

string

उस स्प्रेडशीट का आईडी जिससे डेटा वापस पाया गया था.
valueRanges[]

object (ValueRange)

अनुरोध की गई वैल्यू. वैल्यू रेंज का क्रम, अनुरोध की गई रेंज के क्रम जैसा ही होता है.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.