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