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

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

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

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, Sheets1 के पहले कॉलम के सभी सेल का हवाला देता है.
  • 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 नाम की शीट के सभी सेल को दिखाता है. इसी तरह, शीट 1 में मौजूद सभी सेल का रेफ़रंस दिया गया है. हालांकि, अगर "Sheet1" नाम वाली रेंज है, तो Sheets1 में नाम वाली रेंज और 'Sheet1' शीट के बारे में होगी.
R1C1 नोटेशन

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

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

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

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

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

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

अगले चरण