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रिसॉर्स, किसी शीट को दिखाता है. इसमें यूनीक संख्या वालीsheetIdवैल्यू औरSheetPropertiesऑब्जेक्ट के हिस्से के तौर पर शीटtitleशामिल होती है.- शीट आईडी
- स्प्रेडशीट में मौजूद किसी शीट के लिए यूनीक आइडेंटिफ़ायर. यह एक पूर्णांक होता है. इसमें ऐसी संख्याएं होती हैं जो किसी शीट को रेफ़रंस करती हैं. इसे स्प्रेडशीट के यूआरएल से हासिल किया जा सकता है. शीट का नाम बदलने पर भी, शीट आईडी नहीं बदलते. उदाहरण के लिए, स्प्रेडशीट आईडी देखें.
- सेल
शीट में मौजूद टेक्स्ट या डेटा का कोई फ़ील्ड. सेल को पंक्तियों और कॉलम में व्यवस्थित किया जाता है. साथ ही, उन्हें सेल की रेंज के तौर पर ग्रुप किया जा सकता है.
Cellsरिसॉर्स, हर सेल को दिखाता है. हालांकि, इसमें यूनीक आईडी की वैल्यू नहीं होती. इसके बजाय, सेल की पहचान पंक्ति और कॉलम के कोऑर्डिनेट से होती है.- A1 नोटेशन
- यह सिंटैक्स, किसी सेल या सेल की रेंज को ऐसी स्ट्रिंग के साथ तय करने के लिए इस्तेमाल किया जाता है जिसमें शीट का नाम, कॉलम के अक्षरों और लाइन नंबरों का इस्तेमाल करके शुरुआती और आखिरी सेल के कोऑर्डिनेट शामिल होते हैं. यह तरीका सबसे ज़्यादा इस्तेमाल किया जाता है. साथ ही, यह तब सबसे ज़्यादा काम आता है, जब आपको सेल की किसी ऐब्सलूट रेंज का रेफ़रंस देना हो.
Sheet1!A1:B2का मतलब है कि Sheet1 की पहली दो पंक्तियों और कॉलम की सभी सेल.Sheet1!A:Aका मतलब Sheet1 के पहले कॉलम की सभी सेल से है.Sheet1!1:2, Sheet1 की पहली दो पंक्तियों की सभी सेल को दिखाता है.Sheet1!A5:Aका मतलब है कि Sheet1 के पहले कॉलम की पांचवीं लाइन से लेकर आखिरी लाइन तक की सभी सेल.A1:B2का मतलब है कि पहली शीट की पहली दो लाइनों और कॉलम में मौजूद सभी सेल.Sheet1का मतलब Sheet1 की सभी सेल से है.'Jon's_Data'!A1:D5का मतलब है "Jon's_Data" नाम की शीट की पहली पांच लाइनों और चार कॉलम में मौजूद सभी सेल.'My Custom Sheet'!A:Aका मतलब है "My Custom Sheet" नाम की शीट के पहले कॉलम की सभी सेल.'My Custom Sheet'का मतलब "मेरी कस्टम शीट" की सभी सेल से है.
स्पेस या खास वर्णों वाले शीट के नामों के लिए, सिंगल कोटेशन मार्क ज़रूरी हैं.
सलाह: जहां भी हो सके, अपनी स्प्रेडशीट में मौजूद ऑब्जेक्ट के लिए अलग-अलग नामों का इस्तेमाल करें. उदाहरण के लिए, A1 (बिना कोटेशन मार्क के) का मतलब है कि पहली दिखने वाली शीट में मौजूद सेल A1.
'A1'का मतलब A1 नाम वाली शीट से है. इसी तरह, Sheet1 का मतलब Sheet1 नाम वाली शीट से है. हालांकि, अगर "Sheet1" नाम की कोई रेंज है, तो Sheet1 का मतलब उस रेंज से होगा और'Sheet1'का मतलब शीट से होगा.- R1C1 नोटेशन
- यह एक सिंटैक्स है. इसका इस्तेमाल किसी सेल या सेल की रेंज को तय करने के लिए किया जाता है. इसमें एक स्ट्रिंग होती है. इस स्ट्रिंग में, शीट का नाम, शुरुआती और आखिरी सेल के कोऑर्डिनेट शामिल होते हैं. ये कोऑर्डिनेट, लाइन और कॉलम नंबर का इस्तेमाल करके तय किए जाते हैं. यह तरीका, A1 नोटेशन से कम इस्तेमाल किया जाता है. हालांकि, किसी सेल की पोज़िशन के हिसाब से सेल की किसी रेंज को रेफ़रंस करने के लिए, यह तरीका काम का हो सकता है.
Sheet1!R1C1:R2C2का मतलब Sheet1 की सबसे ऊपर की दो लाइनों में मौजूद पहले दो सेल से है.R1C1:R2C2का मतलब है कि पहली शीट की ऊपर की दो लाइनों में मौजूद पहले दो सेल.Sheet1!R[3]C[1]का मतलब, मौजूदा सेल से तीन लाइन नीचे और एक कॉलम दाईं ओर मौजूद सेल है.
- नाम वाली रेंज
- यह किसी सेल या सेल की रेंज को दिया गया कस्टम नाम होता है. इससे पूरे ऐप्लिकेशन में रेफ़रंस को आसानी से समझा जा सकता है.
FilterViewसंसाधन, नाम वाली किसी रेंज को दिखाता है. - सुरक्षित की गई रेंज
- तय की गई कोई सेल या सेल की रेंज, जिसमें बदलाव नहीं किया जा सकता.
ProtectedRangeसंसाधन, सुरक्षित की गई रेंज को दिखाता है.
मिलते-जुलते विषय
Google Workspace API का इस्तेमाल करके डेवलपमेंट करने के बारे में जानने के लिए, Google Workspace पर डेवलप करें लेख पढ़ें. इसमें पुष्टि करने और अनुमति देने की प्रोसेस को मैनेज करने के बारे में भी बताया गया है.
Sheets API ऐप्लिकेशन को कॉन्फ़िगर करने और चलाने का तरीका जानने के लिए, JavaScript क्विकस्टार्ट आज़माएं.