Google Sheets API की खास जानकारी

Google Sheets API एक RESTful इंटरफ़ेस है. इसकी मदद से, स्प्रेडशीट का डेटा पढ़ा और उसमें बदलाव किया जा सकता है. Sheets API की मदद से ये काम किए जा सकते हैं:

• स्प्रेडशीट बनाना
• स्प्रेडशीट सेल की वैल्यू देखना और उनमें बदलाव करना
• स्प्रेडशीट की फ़ॉर्मैटिंग अपडेट करना
• कनेक्टेड शीट मैनेज करना

Sheets API में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:

स्प्रेडशीट

Google Sheets में मौजूद मुख्य ऑब्जेक्ट. इसमें कई Sheets शामिल हो सकते हैं. हर में, Cells में मौजूद स्ट्रक्चर्ड जानकारी होती है. spreadsheets संसाधन, स्प्रेडशीट को दिखाता है. इसमें यूनीक spreadsheetId वैल्यू शामिल होती है.

स्प्रेडशीट आईडी

स्प्रेडशीट के लिए यूनीक आइडेंटिफ़ायर. यह एक खास स्ट्रिंग होती है. इसमें अक्षर, संख्याएं, और कुछ खास वर्ण होते हैं. यह किसी स्प्रेडशीट का रेफ़रंस देती है. इसे स्प्रेडशीट के यूआरएल से हासिल किया जा सकता है. स्प्रेडशीट का नाम बदलने पर भी, स्प्रेडशीट आईडी नहीं बदलते.

https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID

शीट

स्प्रेडशीट में मौजूद कोई पेज या टैब. Sheets संसाधन, किसी शीट को दिखाता है. इसमें यूनीक संख्या वाली sheetId वैल्यू और शीट title, SheetProperties ऑब्जेक्ट के हिस्से के तौर पर शामिल होती है.

शीट आईडी

स्प्रेडशीट में मौजूद किसी शीट के लिए यूनीक आइडेंटिफ़ायर. यह एक पूर्णांक होता है. इसमें ऐसी संख्याएं होती हैं जो किसी शीट का रेफ़रंस देती हैं. इसे स्प्रेडशीट के यूआरएल से हासिल किया जा सकता है. शीट का नाम बदलने पर भी, शीट आईडी नहीं बदलते. उदाहरण के लिए, स्प्रेडशीट आईडी देखें.

सेल

शीट में मौजूद टेक्स्ट या डेटा का कोई फ़ील्ड. सेल को पंक्तियों और कॉलम में व्यवस्थित किया जाता है. साथ ही, उन्हें सेल की रेंज के तौर पर ग्रुप किया जा सकता है. 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 क्विकस्टार्ट आज़माएं.