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

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