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 रिसॉर्स सुरक्षित रेंज दिखाता है.

अगले चरण