सैंपल

इस सेक्शन में एक कोडलैब दिया गया है, जिसका इस्तेमाल Google Sheets API के बारे में जानने के लिए किया जा सकता है. साथ ही, यहां "रेसिपी" के उदाहरणों का सेट दिया गया है, जो बताता है कि Google Sheets की किसी कार्रवाई को एपीआई अनुरोध में कैसे बदला जा सकता है.

आम तौर पर, एपीआई की मदद से किसी टास्क को पूरा करने के एक से ज़्यादा तरीके होते हैं. किसी काम को करने का तरीका तय करते समय, इन बातों का ध्यान रखें:

• अगर आपको सेल की वैल्यू को पढ़ने या उसमें बदलाव करने की ज़रूरत है, तो spreadsheets कलेक्शन के बजाय spreadsheets.values कलेक्शन का इस्तेमाल करना बेहतर विकल्प है. पढ़ने/लिखने में आसानी के लिए, पहले वाले इंटरफ़ेस का इस्तेमाल करना आसान है.

• जहां भी हो सके, एक ही मेथड कॉल में कई अनुरोधों को शामिल करने के लिए, बैच मेथड (spreadsheet.batchUpdate, spreadsheet.values.batchGet, और spreadsheet.values.batchUpdate) का इस्तेमाल करें. इन बैच मेथड का इस्तेमाल करने से परफ़ॉर्मेंस बेहतर होती है, क्योंकि:

  • क्लाइंट एचटीटीपी ओवरहेड कम करें.
  • क्वेरी की संख्या कम करें.
  • दस्तावेज़ में बदलावों की संख्या कम करें.
  • पक्का करें कि बैच में किए गए सभी बदलाव ज़रूरी हों.

रेसिपी

इस सेक्शन में दिए गए उदाहरणों में बताया गया है कि Sheets API v4 के अनुरोधों के तौर पर, Sheets में सामान्य कार्रवाइयों को कैसे दिखाया जाए.

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

इस सेक्शन में मौजूद रेसिपी को इन कैटगरी में बांटा गया है:

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