Method: spreadsheets.values.get

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

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

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

range

string

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

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

पैरामीटर
majorDimension

enum (Dimension)

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

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

valueRenderOption

enum (ValueRenderOption)

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

dateTimeRenderOption

enum (DateTimeRenderOption)

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

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

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

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में 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

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