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

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