Method: spreadsheets.get

दिए गए आईडी पर स्प्रेडशीट दिखाता है. कॉल करने वाले (कॉलर) को स्प्रेडशीट आईडी बताना होगा.

डिफ़ॉल्ट रूप से, ग्रिड में डेटा नहीं दिखता है. दो में से किसी एक तरीके से ग्रिड डेटा शामिल किया जा सकता है:

  • एचटीटीपी में fields यूआरएल पैरामीटर का इस्तेमाल करके अपनी पसंद के फ़ील्ड की सूची बनाने वाला फ़ील्ड मास्क बताएं

  • includeGridData यूआरएल पैरामीटर को 'सही' पर सेट करें. अगर फ़ील्ड मास्क सेट है, तो includeGridData पैरामीटर को नज़रअंदाज़ किया जाता है

बड़ी स्प्रेडशीट के लिए, सबसे सही तरीके के तौर पर, सिर्फ़ अपनी पसंद के खास स्प्रेडशीट फ़ील्ड फिर से पाएं.

स्प्रेडशीट डेटा के सिर्फ़ सबसेट को पाने के लिए, ranges यूआरएल पैरामीटर का इस्तेमाल करें. रेंज की जानकारी देने के लिए, A1 नोटेशन का इस्तेमाल किया जाता है. आप कोई एक सेल (उदाहरण के लिए, A1) या एक से ज़्यादा सेल (उदाहरण के लिए, A1:D5) तय कर सकते हैं. आप एक ही स्प्रेडशीट में दूसरी शीट के सेल (उदाहरण के लिए, Sheet2!A1:C4) भी पा सकते हैं या एक साथ कई रेंज वापस पा सकते हैं (उदाहरण के लिए, ?ranges=A1:D5&ranges=Sheet2!A1:C4). रेंज की सीमा तय करने से, सिर्फ़ स्प्रेडशीट के वे हिस्से मिलते हैं जो अनुरोध की गई रेंज को बदलते हैं.

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

अनुरोध के लिए स्प्रेडशीट.

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

पैरामीटर
ranges[]

string

स्प्रेडशीट से वापस लाने की रेंज.

includeGridData

boolean

अगर ग्रिड डेटा दिया जाना चाहिए, तो सही है. अगर अनुरोध में फ़ील्ड मास्क सेट किया गया था, तो इस पैरामीटर को अनदेखा कर दिया जाता है.

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

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Spreadsheet का एक इंस्टेंस शामिल किया जाता है.

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

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

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