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 क्विकस्टार्ट आज़माएं.