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

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

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

इस एपीआई में इस्तेमाल किए जाने वाले सामान्य शब्दों की सूची नीचे दी गई है:

स्प्रेडशीट

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

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

शीट

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

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

सेल

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

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

उदाहरण देखें

  • Sheets1 की पहली दो पंक्तियों और कॉलम में मौजूद सभी सेल का मतलब Sheet1!A1:B2 है.
  • Sheet1!A:A, Sheet1 के पहले कॉलम में मौजूद सभी सेल के बारे में बताता है.
  • Sheet1!1:2, Sheet1 की पहली दो पंक्तियों में मौजूद सभी सेल के बारे में बताता है.
  • Sheet1!A5:A, शीट 1 के पहले कॉलम के सभी सेल के बारे में बताता है. ये सेल, पंक्ति 5 और उसके बाद के हैं.
  • A1:B2, दिखने वाली पहली शीट की पहली दो पंक्तियों और कॉलम में मौजूद सभी सेल के बारे में बताता है.
  • Sheet1, Sheet1 में सभी सेल का संदर्भ देता है.
  • 'Jon's_Data'!A1:D5, "Jon's_Data" नाम की शीट की पहली पांच पंक्तियों और चार कॉलम में मौजूद सभी सेल के बारे में बताता है.
  • 'My Custom Sheet'!A:A का मतलब है "मेरी कस्टम शीट" नाम की शीट के पहले कॉलम में मौजूद सभी सेल.
  • 'My Custom Sheet' "मेरी कस्टम शीट" में मौजूद सभी सेल का हवाला देता है.

स्पेस, खास वर्णों या अक्षरों और अंकों के कॉम्बिनेशन वाली शीट के नामों के लिए, सिंगल कोट ज़रूरी हैं.

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

उदाहरण देखें

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