इस दस्तावेज़ में, कोड के सैंपल और कोडलैब दिए गए हैं. इनसे, Google Slides में किए जाने वाले किसी ऐक्शन को Google Slides API के अनुरोध में बदलने का तरीका पता चलता है.
कोड सैंपल
इस सेक्शन में दिए गए कोड सैंपल से पता चलता है कि Slides में किए जाने वाले सामान्य ऐक्शन को Slides API के अनुरोध के तौर पर कैसे दिखाया जाता है.
ये सैंपल, एचटीटीपी अनुरोधों के तौर पर दिखाए जाते हैं, ताकि ये किसी भाषा पर निर्भर न रहें. Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करके, किसी खास भाषा में Slides API के अनुरोध प्रोटोकॉल लागू करने का तरीका जानने के लिए, ये गाइड देखें:
- स्लाइड बनाना
- किसी स्लाइड में शेप और टेक्स्ट जोड़ना
- किसी प्रज़ेंटेशन में डेटा मर्ज करना
- किसी स्लाइड में चार्ट जोड़ना
- टेक्स्ट में बदलाव करना और उसकी स्टाइल बदलना
इस सेक्शन में दिए गए कोड सैंपल को इन कैटगरी में बांटा गया है:
- पढ़ने की बुनियादी कार्रवाइयां: ये सैंपल, किसी प्रज़ेंटेशन से जानकारी पढ़ने के सामान्य तरीके दिखाते हैं
- लिखने की बुनियादी कार्रवाइयां: ये सैंपल, किसी प्रज़ेंटेशन में लिखने के सामान्य तरीके दिखाते हैं
- एलिमेंट से जुड़ी कार्रवाइयां: ये सैंपल, पेज के सामान्य एलिमेंट बनाने और उनमें बदलाव करने के टास्क दिखाते हैं
- प्रज़ेंटेशन से जुड़ी कार्रवाइयां: ये सैंपल, प्रज़ेंटेशन बनाने और उसमें बदलाव करने का तरीका दिखाते हैं
- स्लाइड से जुड़ी कार्रवाइयां: ये सैंपल, किसी प्रज़ेंटेशन में स्लाइड बनाने, उन्हें मूव करने, और मिटाने का तरीका दिखाते हैं
- टेबल से जुड़ी कार्रवाइयां: ये सैंपल, किसी स्लाइड में टेबल बनाने और उनमें बदलाव करने का तरीका दिखाते हैं
- बदलाव से जुड़ी कार्रवाइयां: ये सैंपल किसी स्लाइड में एलिमेंट का साइज़ और पोज़िशन बदलने का तरीका दिखाते हैं
Codelab
Slides के कोडलैब से, आपको Slides API को सॉफ़्टवेयर के सबसे सामान्य लाइसेंस का विश्लेषण करने के लिए, पसंद के मुताबिक बनाए गए प्रज़ेंटेशन टूल के तौर पर इस्तेमाल करने का तरीका पता चलता है.
आपको BigQuery का इस्तेमाल करके, GitHub पर मौजूद सभी ओपन सोर्स कोड की क्वेरी करने और अपने नतीजों को दिखाने के लिए, Slides API का इस्तेमाल करके स्लाइड डेक बनाने का तरीका पता चलेगा.
सबसे सही तरीके
Slides API की मदद से, किसी दिए गए टास्क को पूरा करने के एक से ज़्यादा तरीके हो सकते हैं. एक से ज़्यादा अपडेट के अनुरोधों को एक ही तरीके से कॉल करने के लिए, जहां भी हो सके, बैच वाले तरीके
presentations.batchUpdate
का इस्तेमाल करें.
इससे, क्लाइंट के एचटीटीपी ओवरहेड को कम किया जा सकता है, क्वेरी की संख्या कम की जा सकती है, प्रज़ेंटेशन में किए जाने वाले बदलावों की संख्या कम की जा सकती है, और सभी बदलाव एक साथ लागू किए जा सकते हैं.
परफ़ॉर्मेंस को और बेहतर बनाने के लिए, प्रज़ेंटेशन, पेजों, और पेज के एलिमेंट को पढ़ते और अपडेट करते समय, फ़ील्ड मास्क का इस्तेमाल करें.