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 है.

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "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

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