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