Google Sheets API एक RESTful इंटरफ़ेस है, जो आपको किसी दस्तावेज़ में मौजूद डेटा देखें. इस एपीआई का इस्तेमाल आम तौर पर, ये काम करने के लिए किया जाता है टास्क:
- स्प्रेडशीट बनाना
- स्प्रेडशीट की सेल की वैल्यू पढ़ें और लिखें
- स्प्रेडशीट की फ़ॉर्मैटिंग अपडेट करना
- कनेक्टेड शीट मैनेज करना
इस एपीआई में इस्तेमाल किए जाने वाले सामान्य शब्दों की सूची नीचे दी गई है:
- स्प्रेडशीट
Google Sheets का मुख्य ऑब्जेक्ट, जिसमें हर शीट में कई शीट हो सकती हैं व्यवस्थित जानकारी के साथ दिखाया जाता है.
Spreadsheet
संसाधन सभी स्प्रेडशीट है और उसकीspreadsheetId
वैल्यू, जिसमें अक्षर, नंबर, हाइफ़न या अंडरस्कोर होने चाहिए. आप Google Sheets के यूआरएल में स्प्रेडशीट आईडी:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- शीट
स्प्रेडशीट में मौजूद कोई पेज या टैब.
Sheet
संसाधन हर एक के बारे में बताता है होती है और इसका टाइटल बिलकुल अलग है औरsheetId
वैल्यू. आपने लोगों तक पहुंचाया मुफ़्त में Google Sheets के यूआरएल में शीट आईडी मिल सकता है:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- सेल
शीट में मौजूद टेक्स्ट या डेटा का अलग फ़ील्ड. सेल पंक्तियों में व्यवस्थित किए गए हैं और कॉलम की वैल्यू को दिखाएगा. इसे सेल की रेंज के तौर पर ग्रुप किया जा सकता है.
CellData
संसाधन हर एक के बारे में बताता है सेल है, लेकिन इसमें यूनीक आईडी की वैल्यू नहीं है. इसके बजाय, पंक्ति और कॉलम निर्देशांकों से सेल की पहचान होती है.- A1 नोटेशन
- एक सिंटैक्स जिसका इस्तेमाल ऐसी स्ट्रिंग वाली सेल या सेल की रेंज को तय करने के लिए किया जाता है जिसमें इसमें शीट का नाम और शुरुआती और आखिरी सेल के निर्देशांक शामिल हैं कॉलम के अक्षर और पंक्ति नंबर. यह तरीका सबसे ज़्यादा इस्तेमाल होने वाला और फ़ायदेमंद है और सेल की ऐब्सलूट रेंज का रेफ़रंस देते हैं.
उदाहरण देखें
- Sheets1 की पहली दो पंक्तियों और कॉलम में मौजूद सभी सेल का मतलब
Sheet1!A1:B2
है. Sheet1!A:A
, Sheet1 के पहले कॉलम में मौजूद सभी सेल के बारे में बताता है.Sheet1!1:2
, Sheet1 की पहली दो पंक्तियों में मौजूद सभी सेल के बारे में बताता है.Sheet1!A5:A
, शीट 1 के पहले कॉलम के सभी सेल के बारे में बताता है. ये सेल, पंक्ति 5 और उसके बाद के हैं.A1:B2
, दिखने वाली पहली शीट की पहली दो पंक्तियों और कॉलम में मौजूद सभी सेल के बारे में बताता है.Sheet1
, Sheet1 में सभी सेल का संदर्भ देता है.'Jon's_Data'!A1:D5
, "Jon's_Data" नाम की शीट की पहली पांच पंक्तियों और चार कॉलम में मौजूद सभी सेल के बारे में बताता है.'My Custom Sheet'!A:A
का मतलब है "मेरी कस्टम शीट" नाम की शीट के पहले कॉलम में मौजूद सभी सेल.'My Custom Sheet'
"मेरी कस्टम शीट" में मौजूद सभी सेल का हवाला देता है.
स्पेस, खास वर्णों या अक्षरों और अंकों के कॉम्बिनेशन वाली शीट के नामों के लिए, सिंगल कोट ज़रूरी हैं.
सलाह: जहां भी हो सके, अपनी स्प्रेडशीट में ऑब्जेक्ट के लिए अलग-अलग नाम इस्तेमाल करें. उदाहरण के लिए, A1 दिखने वाली पहली शीट के सेल A1 को दिखाता है, जबकि
A1
, "A1" नाम की शीट के सभी सेल को दिखाता है. इसी तरह,Sheet1
, Sheet1 में मौजूद सभी सेल का हवाला देता है. हालांकि, अगर "Sheet1" टाइटल वाली किसी रेंज का नाम दिया गया है, तो Sheet1 नाम वाली रेंज को औरSheet1
, शीट को दिखाता है.- R1C1 नोटेशन
- एक सिंटैक्स जिसका इस्तेमाल ऐसी स्ट्रिंग वाली सेल या सेल की रेंज को तय करने के लिए किया जाता है जिसमें इसमें शीट का नाम और शुरुआती और आखिरी सेल के निर्देशांक शामिल हैं पंक्ति संख्या और कॉलम संख्या. यह तरीका, A1 नोटेशन से कम इस्तेमाल होता है. हालांकि, किसी दिए गए डेटा से मिलते-जुलते सेल की रेंज का रेफ़रंस देते समय यह काम आ सकता है सेल की पोज़िशन पर सेट करें.
उदाहरण देखें
Sheet1!R1C1:R2C2
का मतलब है, Sheets1 की ऊपर की दो पंक्तियों में मौजूद पहली दो सेल.R1C1:R2C2
का मतलब है, दिखने वाली पहली शीट की ऊपरी दो पंक्तियों में मौजूद पहली दो सेल.Sheet1!R[3]C[1]
का मतलब वह सेल है जो नीचे तीन पंक्तियां है और मौजूदा सेल के दाईं ओर एक कॉलम है.
- नाम वाली रेंज
- कोई तय सेल या सेल की रेंज, जिसे आसान बनाने के लिए पसंद के मुताबिक नाम दिया गया हो
रेफ़रंस.
FilterView
संसाधन नाम वाली रेंज दिखाता है. - सुरक्षित की गई रेंज
- तय किया गया ऐसा सेल या सेल की रेंज जिसमें बदलाव नहीं किया जा सकता. ऐप्लिकेशन
ProtectedRange
संसाधन सुरक्षित रेंज दिखाता है.
मिलते-जुलते विषय
Google Workspace API के साथ डेवलप करने और उन्हें मैनेज करने का तरीका जानने के लिए प्रमाणीकरण और प्राधिकरण के बारे में. Google Workspace.
Sheets API ऐप्लिकेशन को कॉन्फ़िगर करने और उसे चलाने का तरीका जानने के लिए, क्विकस्टार्ट के बारे में खास जानकारी.