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

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

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

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

स्प्रेडशीट

Google Sheets में मुख्य ऑब्जेक्ट. इसमें कई Sheets हो सकते हैं. हर Sheets में Cells में मौजूद स्ट्रक्चर्ड जानकारी होती है. spreadsheets संसाधन, स्प्रेडशीट को दिखाता है. इसमें एक यूनीक spreadsheetId वैल्यू शामिल है.

स्प्रेडशीट आईडी
स्प्रेडशीट का यूनीक आइडेंटिफ़ायर. यह एक खास स्ट्रिंग होती है, जिसमें अक्षर, संख्याएं, और कुछ खास वर्ण होते हैं. ये वर्ण स्प्रेडशीट का रेफ़रंस देते हैं. इसे स्प्रेडशीट के यूआरएल से लिया जा सकता है. स्प्रेडशीट का नाम बदलने पर भी, स्प्रेडशीट के आईडी में कोई बदलाव नहीं होता.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
शीट

स्प्रेडशीट में मौजूद पेज या टैब. Sheets संसाधन, किसी शीट को दिखाता है. इसमें, SheetProperties ऑब्जेक्ट के हिस्से के तौर पर, एक यूनीक अंकों वाली sheetId वैल्यू और शीटtitle शामिल होती है.

शीट आईडी
स्प्रेडशीट में मौजूद किसी शीट का यूनीक आइडेंटिफ़ायर. यह एक ऐसी स्ट्रिंग होती है जिसमें अक्षर, संख्याएं, और कुछ खास वर्ण होते हैं. ये वर्ण किसी शीट का रेफ़रंस देते हैं. इसे स्प्रेडशीट के यूआरएल से लिया जा सकता है. शीट का नाम बदलने पर भी, शीट के आईडी में कोई बदलाव नहीं होता. उदाहरण के लिए, स्प्रेडशीट आईडी देखें.
सेल

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

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

उदाहरण देखें

  • Sheet1!A1:B2 से, Sheet1 की पहली दो पंक्तियों और कॉलम की सभी सेल का पता चलता है.
  • 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 है. हालांकि, अगर "शीट1" नाम की कोई रेंज है, तो शीट1 का मतलब नाम वाली रेंज से है और 'Sheet1' का मतलब शीट से है.

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

उदाहरण देखें

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

  • Sheets API ऐप्लिकेशन को कॉन्फ़िगर करने और चलाने का तरीका जानने के लिए, JavaScript क्विकस्टार्ट आज़माएं.