Google Sheets API, RESTful इंटरफ़ेस है. इसकी मदद से, स्प्रेडशीट का डेटा पढ़ा और उसमें बदलाव किया जा सकता है. Sheets API की मदद से:
- स्प्रेडशीट बनाना
- स्प्रेडशीट सेल की वैल्यू पढ़ना और उनमें बदलाव करना
- स्प्रेडशीट का फ़ॉर्मैट अपडेट करना
- कनेक्टेड शीट मैनेज करना
Sheets API में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:
- स्प्रेडशीट
Google Sheets में मुख्य ऑब्जेक्ट. इसमें कई
Sheetsहो सकते हैं. हरSheetsमेंCellsमें मौजूद स्ट्रक्चर्ड जानकारी होती है.spreadsheetsसंसाधन, स्प्रेडशीट को दिखाता है. इसमें एक यूनीकspreadsheetIdवैल्यू शामिल है.- स्प्रेडशीट आईडी
- स्प्रेडशीट का यूनीक आइडेंटिफ़ायर. यह एक खास स्ट्रिंग होती है, जिसमें अक्षर, संख्याएं, और कुछ खास वर्ण होते हैं. ये वर्ण स्प्रेडशीट का रेफ़रंस देते हैं. इसे स्प्रेडशीट के यूआरएल से लिया जा सकता है. स्प्रेडशीट का नाम बदलने पर भी, स्प्रेडशीट के आईडी में कोई बदलाव नहीं होता.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID- शीट
स्प्रेडशीट में मौजूद कोई पेज या टैब.
Sheetsसंसाधन, किसी शीट को दिखाता है. इसमें,SheetPropertiesऑब्जेक्ट के हिस्से के तौर पर, एक यूनीक अंकों वालीsheetIdवैल्यू और शीटtitleशामिल होती है.- शीट आईडी
- स्प्रेडशीट में मौजूद किसी शीट का यूनीक आइडेंटिफ़ायर. यह एक ऐसी स्ट्रिंग होती है जिसमें अक्षर, संख्याएं, और कुछ खास वर्ण होते हैं. ये वर्ण किसी शीट का रेफ़रंस देते हैं. इसे स्प्रेडशीट के यूआरएल से लिया जा सकता है. शीट का नाम बदलने पर भी, शीट के आईडी में कोई बदलाव नहीं होता. उदाहरण के लिए, स्प्रेडशीट आईडी देखें.
- सेल
शीट में टेक्स्ट या डेटा का कोई फ़ील्ड. सेल को पंक्तियों और कॉलम में व्यवस्थित किया जाता है. साथ ही, इन्हें सेल की रेंज के तौर पर ग्रुप किया जा सकता है.
Cellsरिसॉर्स, हर सेल को दिखाता है. हालांकि, इसमें यूनीक आईडी वैल्यू नहीं होती. इसके बजाय, पंक्ति और कॉलम निर्देशांक सेल की पहचान करते हैं.- A1 नोटेशन
- एक सिंटैक्स, जिसका इस्तेमाल किसी सेल या सेल की रेंज को तय करने के लिए किया जाता है. यह सिंटैक्स, शीट के नाम के साथ-साथ कॉलम के अक्षरों और पंक्ति की संख्याओं का इस्तेमाल करके, सेल के शुरुआती और आखिरी निर्देशों की जानकारी देता है. सेल की ऐब्सलूट रेंज का रेफ़रंस देते समय, यह तरीका सबसे सामान्य और काम का होता है.
उदाहरण देखें
Sheet1!A1:B2से Sheet1 की पहली दो पंक्तियों और कॉलम की सभी सेल का पता चलता है.Sheet1!A:Aसे Sheet1 के पहले कॉलम की सभी सेल का पता चलता है.Sheet1!1:2, Sheet1 की पहली दो पंक्तियों की सभी सेल को रेफ़र करता है.Sheet1!A5:Aसे शीट 1 के पहले कॉलम की पांचवीं पंक्ति से लेकर आखिरी पंक्ति तक की सभी सेल का पता चलता है.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 है. हालांकि, अगर "शीट1" नाम की कोई रेंज है, तो शीट1 का मतलब नाम वाली रेंज से है और'Sheet1'का मतलब शीट से है.- R1C1 नोटेशन
- यह एक सिंटैक्स है, जिसका इस्तेमाल किसी सेल या सेल की रेंज को तय करने के लिए किया जाता है. इसमें शीट का नाम और पंक्ति संख्याओं और कॉलम संख्याओं का इस्तेमाल करके, सेल के शुरुआती और आखिरी निर्देश शामिल होते हैं. यह तरीका, A1 नोटेशन के मुकाबले कम इस्तेमाल किया जाता है. हालांकि, किसी सेल की पोज़िशन के हिसाब से सेल की रेंज का रेफ़रंस देते समय, यह तरीका मददगार हो सकता है.
उदाहरण देखें
Sheet1!R1C1:R2C2का मतलब है कि Sheet1 की ऊपरी दो पंक्तियों में मौजूद पहली दो सेल.R1C1:R2C2, दिख रही पहली शीट की ऊपरी दो पंक्तियों में मौजूद पहली दो सेल को दिखाता है.Sheet1!R[3]C[1]से उस सेल का पता चलता है जो मौजूदा सेल से तीन पंक्तियां नीचे और एक कॉलम दाईं ओर है.
- नाम वाली रेंज
- ऐप्लिकेशन में रेफ़रंस को आसान बनाने के लिए, कस्टम नाम वाली सेल या सेल की रेंज.
FilterViewवाला संसाधन, नाम वाली रेंज दिखाता है. - सुरक्षित की गई रेंज
- तय की गई सेल या सेल की ऐसी रेंज जिसमें बदलाव नहीं किया जा सकता.
ProtectedRangeसंसाधन, सुरक्षित की गई रेंज को दिखाता है.
मिलते-जुलते विषय
Google Workspace के एपीआई का इस्तेमाल करके ऐप्लिकेशन डेवलप करने के बारे में जानने के लिए, Google Workspace पर ऐप्लिकेशन डेवलप करना लेख पढ़ें. इसमें पुष्टि करने और अनुमति देने की सुविधा के बारे में भी बताया गया है.
Sheets API ऐप्लिकेशन को कॉन्फ़िगर और चलाने का तरीका जानने के लिए, JavaScript के लिए क्विकस्टार्ट आज़माएं.