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

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

boolean

अगर बैंडेड रेंज में टेबल शामिल नहीं करनी हैं, तो इस विकल्प को 'सही' पर सेट करें. अगर इसे सेट नहीं किया जाता है, तो इसकी वैल्यू 'गलत है' होती है.
commentsViewMode

enum (CommentsViewMode)

स्प्रेडशीट पर टिप्पणियां देखने का मोड. इससे टिप्पणियों के साथ या उनके बिना स्प्रेडशीट देखी जा सकती है. अगर कोई वैल्यू नहीं दी गई है, तो COMMENTS_VIEW_MODE_OMITTED का इस्तेमाल किया जाता है.

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

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

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

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

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