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

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

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

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

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

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

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