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

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

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

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

स्प्रेडशीट

Google Sheets का मुख्य ऑब्जेक्ट, जिसमें कई शीट हो सकती हैं. हर शीट में सेल में मौजूद स्ट्रक्चर्ड जानकारी होती है. स्प्रेडशीट संसाधन हर स्प्रेडशीट के बारे में बताता है और इसकी एक खास 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, Sheet1 की पहली दो पंक्तियों में मौजूद सभी सेल के बारे में बताता है.
  • Sheet1!A5:A शीट 1 के पहले कॉलम के सभी सेल के बारे में बताता है. ये सेल, 5 और उसके बाद की सेल के होते हैं.
  • A1:B2 का मतलब है, दिखने वाली पहली शीट की ऊपरी दो पंक्तियों में मौजूद पहली दो सेल.
  • Sheet1, Sheet1 में सभी सेल का संदर्भ देता है.
  • 'My Custom Sheet'!A:A का मतलब है "मेरी कस्टम शीट" नाम की शीट के पहले कॉलम में मौजूद सभी सेल. स्पेस, खास वर्णों या अक्षरों और अंकों के कॉम्बिनेशन वाली शीट के नामों के लिए, सिंगल कोट ज़रूरी हैं.
  • 'My Custom Sheet', 'मेरी कस्टम शीट' में मौजूद सभी सेल का हवाला देता है.

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

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

उदाहरण देखें

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

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

सुरक्षित की गई रेंज

तय की गई सेल या सेल की वह रेंज जिसमें बदलाव नहीं किया जा सकता. ProtectedRange रिसॉर्स सुरक्षित रेंज दिखाता है.

अगले चरण