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 है, तो इसे अनदेखा कर दिया जाता है. तारीख और समय के लिए, रेंडर करने का डिफ़ॉल्ट विकल्प SERIAL_NUMBER है.

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

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

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

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

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

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

string

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

object (ValueRange)

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

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

इनमें से किसी एक 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

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