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

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

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

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

स्प्रेडशीट

Google शीट का मुख्य ऑब्जेक्ट, जिसमें एक से ज़्यादा शीट हो सकती हैं. हर शीट में सेल में मौजूद स्ट्रक्चर्ड जानकारी होती है. स्प्रेडशीट रिसॉर्स, हर स्प्रेडशीट को दिखाता है और इसकी एक खास spreadsheetId वैल्यू होती है. इसमें अक्षर, नंबर, हाइफ़न या अंडरस्कोर शामिल होते हैं. स्प्रेडशीट आईडी को Google Sheets के यूआरएल में देखा जा सकता है:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

शीट

स्प्रेडशीट में मौजूद कोई पेज या टैब. शीट संसाधन हर शीट के बारे में बताता है और इसमें एक खास शीर्षक और संख्या sheetId वैल्यू होती है. शीट आईडी को Google Sheets के यूआरएल में देखा जा सकता है:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

सेल

शीट में टेक्स्ट या डेटा का अलग फ़ील्ड. सेल को पंक्तियों और कॉलम में व्यवस्थित किया जाता है और उन्हें सेल की रेंज के तौर पर ग्रुप किया जा सकता है. CellData संसाधन हर सेल को दिखाता है, लेकिन इसमें कोई यूनीक आईडी वैल्यू नहीं होती. इसके बजाय, पंक्ति और कॉलम निर्देशांक सेल की पहचान करते हैं.

A1 नोटेशन

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

उदाहरण दिखाएं

  • Sheet1!A1:B2, Sheets1 की ऊपरी दो पंक्तियों में पहले दो सेल का हवाला देता है.
  • Sheet1!A:A, Sheet1 के पहले कॉलम के सभी सेल का रेफ़रंस देता है.
  • Sheet1!1:2, Sheets1 की पहली दो पंक्तियों के सभी सेल का हवाला देता है.
  • Sheet1!A5:A, शीट 1 के पहले कॉलम की पंक्ति 5 और उसके बाद के सभी सेल के बारे में बताता है.
  • A1:B2, दिखाई देने वाली पहली शीट की ऊपरी दो पंक्तियों में पहले दो सेल का हवाला देता है.
  • Sheet1, Sheets1 में मौजूद सभी सेल का हवाला देता है.
  • 'My Custom Sheet'!A:A में, "मेरी कस्टम शीट" नाम की शीट के पहले कॉलम के सभी सेल मौजूद होते हैं. खाली जगह, खास वर्णों या अक्षर और अंक के कॉम्बिनेशन वाली शीट के नामों के लिए सिंगल कोट की ज़रूरत होती है.
  • 'My Custom Sheet' 'मेरी कस्टम शीट' के सभी सेल दिखाता है.

सलाह: जहां संभव हो, अपनी स्प्रेडशीट में ऑब्जेक्ट के लिए अलग-अलग नामों का इस्तेमाल करें. उदाहरण के लिए, A1 पहली शीट में मौजूद सेल A1 को दिखाता है, जबकि 'A1' A1 नाम वाली शीट के सभी सेल के बारे में बताता है. इसी तरह, Sheets1 में Sheets की सभी सेल मौजूद हैं. हालांकि, अगर "Sheet1" टाइटल वाली रेंज है, तो Sheets1 में नाम वाली रेंज होगी और 'Sheet1' शीट का मतलब होगा.
R1C1 नोटेशन

सिंटैक्स का इस्तेमाल ऐसी स्ट्रिंग या सेल की रेंज के बारे में बताने के लिए किया जाता है जिसमें शीट का नाम होता है. साथ ही, पंक्तियों की संख्या और कॉलम नंबर का इस्तेमाल करके, सेल के शुरुआती और आखिरी कोऑर्डिनेट होते हैं. यह तरीका A1 नोटेशन की तुलना में कम आम है, लेकिन किसी सेल की स्थिति के हिसाब से सेल की रेंज का रेफ़रंस देते समय काम आ सकता है.

उदाहरण दिखाएं

  • Sheet1!R1C1:R2C2, Sheets1 की ऊपरी दो पंक्तियों में पहले दो सेल का हवाला देता है.
  • R1C1:R2C2, दिखाई देने वाली पहली शीट की ऊपरी दो पंक्तियों में पहले दो सेल का हवाला देता है.
  • Sheet1!R[3]C[1] उस सेल को दर्शाता है जिसमें नीचे तीन पंक्तियां और मौजूदा सेल के दाईं ओर एक कॉलम होता है.
नाम वाली रेंज

किसी ऐप्लिकेशन में रेफ़रंस को आसान बनाने के लिए, पसंद के मुताबिक नाम वाला तय सेल या सेल की रेंज. FilterView संसाधन एक नाम वाली रेंज को दिखाता है.

सुरक्षित रेंज

तय किया गया सेल या सेल की रेंज, जिसमें बदलाव नहीं किया जा सकता. A ProtectedRange संसाधन एक सुरक्षित रेंज को दिखाता है.

अगले चरण