सैंपल

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

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

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

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

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

रेसिपी

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

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

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

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