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