इस सेक्शन में, एक कोडलैब दिया गया है. इसका इस्तेमाल करके, Google Sheets API के बारे में जाना जा सकता है. इसमें "रेसिपी" के कुछ उदाहरण भी दिए गए हैं. इनसे पता चलता है कि Google Sheets में की जाने वाली किसी कार्रवाई को एपीआई अनुरोध में कैसे बदला जाता है.
अक्सर, एपीआई की मदद से किसी दिए गए टास्क को पूरा करने के एक से ज़्यादा तरीके होते हैं. किसी टास्क को पूरा करने का तरीका तय करते समय, इन बातों का ध्यान रखें:
- अगर आपको सेल की वैल्यू पढ़नी या लिखनी है, तो
spreadsheets.valuesकलेक्शन के बजायspreadsheetsकलेक्शन का इस्तेमाल करना बेहतर होता है. पहले वाले कलेक्शन का इंटरफ़ेस, पढ़ने/लिखने की सामान्य कार्रवाइयों के लिए इस्तेमाल करना आसान होता है. जहां भी संभव हो, एक से ज़्यादा अनुरोधों को एक ही करने का तरीका कॉल में बंडल करने के लिए, बैच के तरीकों (
spreadsheet.batchUpdate,spreadsheet.values.batchGet, औरspreadsheet.values.batchUpdate) का इस्तेमाल करें. बैच के इन तरीकों का इस्तेमाल करने से, काम की रफ़्तार बढ़ती है, क्योंकि इनसे:- क्लाइंट के एचटीटीपी ओवरहेड को कम किया जा सकता है.
- क्वेरी की संख्या कम की जा सकती है.
- दस्तावेज़ में किए जाने वाले बदलावों की संख्या कम की जा सकती है.
- बैच में किए गए सभी बदलावों को एक साथ लागू किया जा सकता है.
रेसिपी
इस सेक्शन में दिए गए उदाहरणों से पता चलता है कि Sheets में की जाने वाली सामान्य कार्रवाइयों को, Sheets API v4 के अनुरोधों के तौर पर कैसे दिखाया जाता है.
इन उदाहरणों को, भाषा से अलग रखने के लिए, एचटीटीपी अनुरोधों के तौर पर दिखाया गया है. Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करके, किसी खास भाषा में Sheets API के अनुरोध प्रोटोकॉल लागू करने का तरीका जानने के लिए, सेल की वैल्यू पढ़ना और लिखना और स्प्रेडशीट अपडेट करना गाइड देखें.
इस सेक्शन में दी गई रेसिपी को इन कैटगरी में बांटा गया है:
- पढ़ने की बुनियादी कार्रवाइयां—इन रेसिपी से पता चलता है कि किसी शीट से वैल्यू कैसे पढ़ी जाती हैं.
- लिखने की बुनियादी कार्रवाइयां—इन रेसिपी से पता चलता है कि किसी शीट में वैल्यू कैसे लिखी जाती हैं.
- फ़ॉर्मैटिंग की बुनियादी कार्रवाइयां—इन रेसिपी से पता चलता है कि शीट और सेल का लुक कैसे बदला जाता है.
- चार्ट—इन रेसिपी से पता चलता है कि किसी शीट में चार्ट कैसे बनाए जाते हैं और उनमें बदलाव कैसे किया जाता है.
- सशर्त फ़ॉर्मैटिंग— इन रेसिपी से पता चलता है कि शर्तों के आधार पर सेल का लुक कैसे बदला जाता है.
- डेटा से जुड़ी कार्रवाइयां—इन रेसिपी से पता चलता है कि किसी स्प्रेडशीट में डेटा कैसे बनाया जाता है, उसे कैसे मूव किया जाता है, और उसमें कैसे बदलाव किया जाता है.
- नाम वाले और सुरक्षित किए गए रेंज—इन रेसिपी से पता चलता है कि किसी स्प्रेडशीट में नाम वाले और सुरक्षित किए गए रेंज कैसे बनाए जाते हैं, उन्हें कैसे अपडेट किया जाता है, और उन्हें कैसे हटाया जाता है.
- पिवट टेबल—इन रेसिपी से पता चलता है कि किसी शीट में पिवट टेबल कैसे बनाई जाती हैं.
- पंक्ति और कॉलम से जुड़ी कार्रवाइयां—इन रेसिपी से पता चलता है कि पंक्तियां और कॉलम कैसे जोड़े, हटाए, और मूव किए जाते हैं. साथ ही, उनकी प्रॉपर्टी कैसे अपडेट की जाती हैं.
- शीट से जुड़ी कार्रवाइयां—इन रेसिपी से पता चलता है कि शीट कैसे बनाई, साफ़ की, कॉपी की, और मिटाई जाती हैं. साथ ही, उनकी प्रॉपर्टी को कैसे कंट्रोल किया जाता है.