Google Slides API का एक मददगार ऐप्लिकेशन यह है कि आप एक से ज़्यादा जानकारी को मर्ज करें या उससे ज़्यादा डेटा सोर्स को टेंप्लेट वाले स्लाइड डेक में जोड़ सकते हैं.
इस पेज में बताया गया है कि किसी बाहरी सोर्स से डेटा कैसे लिया जा सकता है और उसे एक मौजूदा टेंप्लेट प्रज़ेंटेशन में शामिल करें. यह सिद्धांत है यह बिलकुल वैसा ही है जैसा किसी वर्ड प्रोसेसर और स्प्रेडशीट का इस्तेमाल करके मेल मर्ज किया जाता है.
यह तरीका उपयोगी होने के कई कारण हैं:
किसी प्रज़ेंटेशन का डिज़ाइन बेहतर बनाने के लिए, डिज़ाइनर Google Slides एडिटर में. यह पैरामीटर ट्यूनिंग से कहीं ज़्यादा आसान है आपके ऐप्लिकेशन का इस्तेमाल करके, रेंडर की गई स्लाइड का डिज़ाइन सेट किया जा सकता है.
प्रज़ेंटेशन से कॉन्टेंट को अलग करना एक जाना-माना डिज़ाइन है साथ ही, कई फ़ायदे भी मिलते हैं.
एक बुनियादी रेसिपी
इस उदाहरण में बताया गया है कि प्रज़ेंटेशन में डेटा मर्ज करने के लिए, Slides API का इस्तेमाल कैसे किया जा सकता है:
प्रज़ेंटेशन को वैसा ही बनाएं जैसा वह आपको दिखाना है प्लेसहोल्डर कॉन्टेंट की मदद से, डिज़ाइन में मदद पाएं.
डाले जाने वाले हर कॉन्टेंट एलिमेंट के लिए, प्लेसहोल्डर बदलें कॉन्टेंट टैग करना. टैग, यूनीक स्ट्रिंग वाले टेक्स्ट बॉक्स या आकार होते हैं. ऐसी स्ट्रिंग का इस्तेमाल करें जिनके सामान्य रूप से आने की संभावना न हो. उदाहरण के लिए,
{{account-holder-name}}
एक अच्छा टैग हो सकता है.अपने कोड में, Google Drive API का इस्तेमाल करके, के साथ अपनी स्क्रीन शेयर करें.
अपने कोड में, Slides API की
batchUpdate
तरीका है, जिसमेंreplaceAllText
पूरे प्रज़ेंटेशन में सभी टेक्स्ट के प्रतिस्थापनों को पूरा करने के लिए किया जाता है.replaceAllShapesWithImage
का इस्तेमाल करें पूरे प्रज़ेंटेशन के दौरान इमेज को बदलने के अनुरोध करते हैं.
टैग वाला डेक बनाने के बाद, उसकी कॉपी बनाना न भूलें और कॉपी में बदलाव करने के लिए Slides API का इस्तेमाल करें. Slides API का इस्तेमाल न करें आपके प्राइमरी "टेंप्लेट" में बदलाव करने के लिए कॉपी करें!
नीचे दिए गए सेक्शन में ऐसे कोड स्निपेट शामिल हैं जिनमें यह जानकारी दी गई है प्रोसेस. पूरा उदाहरण देखने के लिए, ऊपर दिया गया वीडियो भी देखा जा सकता है (Python) नीचे दिए गए अलग-अलग सेक्शन के कई कॉन्सेप्ट को मिलाकर, इस्तेमाल किया जा सकता है.
टेक्स्ट मर्ज करें
replaceAllText
का इस्तेमाल किया जा सकता है
में दी गई टेक्स्ट स्ट्रिंग के सभी इंस्टेंस को
नए टेक्स्ट के साथ प्रज़ेंटेशन. मर्ज के लिए, यह इससे आसान है
टेक्स्ट के हर इंस्टेंस को अलग-अलग खोज और बदल सकता है. इसकी एक वजह यह है कि
सबसे जटिल तरीका यह है कि पेज एलिमेंट आईडी का अनुमान लगाना मुश्किल होता है,
खासकर जब सहयोगी, टेंप्लेट को बेहतर बनाते और मैनेज करते हैं
के साथ अपनी स्क्रीन शेयर करें.
उदाहरण
इस उदाहरण में टेंप्लेट प्रज़ेंटेशन को कॉपी करने के लिए, Drive API का इस्तेमाल किया गया है. इससे पर क्लिक करें. इसके बाद, यह डेटा देखने के लिए Google Sheets API का इस्तेमाल करता है से निकालता है और अंत में स्लाइड API का उपयोग करके नया प्रज़ेंटेशन बनाया जा सकता है.
उदाहरण में, नाम वाली रेंज की एक लाइन के तीन सेल का डेटा लिया गया है
स्प्रेडशीट. इसके बाद, वह उस डेटा को प्रज़ेंटेशन में शामिल कर देता है,
स्ट्रिंग {{customer-name}}
,
{{case-description}}
या
{{total-portfolio}}
आया.
Apps Script
शुरू करें
Java
JavaScript
Node.js
PHP
Python
Ruby
इमेज मर्ज करें
प्रज़ेंटेशन में इमेज मर्ज करने के लिए,
replaceAllShapesWithImage
अनुरोध. यह अनुरोध उन सभी आकृतियों को बदल देता है जिनमें
दी गई इमेज के साथ दी गई टेक्स्ट स्ट्रिंग. अनुरोध अपने-आप होना
टैग के आकार की सीमाओं में फ़िट होने के लिए इमेज को व्यवस्थित करता है और उसे फ़िट करता है.
इमेज के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को बनाए रखते हुए.
उदाहरण
इस उदाहरण में टेंप्लेट प्रज़ेंटेशन को कॉपी करने के लिए, Google Drive API का इस्तेमाल किया गया है. इससे
पर क्लिक करें. इसके बाद, यह ढूंढने के लिए Slides API का इस्तेमाल करता है
{{company-logo}}
टेक्स्ट वाला कोई भी आकार
और इसकी जगह कंपनी के लोगो की इमेज लगानी होगी. यह अनुरोध किसी भी
{{customer-graphic}}
टेक्स्ट वाला आकार
पर क्लिक करें.
Apps Script
शुरू करें
Java
JavaScript
Node.js
PHP
Python
Ruby
खास टेक्स्ट बॉक्स या इमेज के उदाहरण बदलें
replaceAllText
और replaceAllShapesWithImage
पूरे प्रज़ेंटेशन में टैग बदलने के लिए अनुरोध काम के होते हैं, लेकिन
कभी-कभी आपको एलिमेंट को सिर्फ़ किसी दूसरी शर्त के हिसाब से बदलना पड़ता है, जैसे
का मतलब है किसी खास स्लाइड पर.
इन मामलों में, आपको अपने टैग के आकार के आईडी, फिर से पाने होंगे बदलना चाहते हैं. टेक्स्ट बदलने के लिए, मौजूदा टेक्स्ट मिटाएं टेक्स्ट जोड़ें और फिर नया टेक्स्ट शामिल करें (सैंपल देखें किसी खास आकार में टेक्स्ट में बदलाव करें).
इमेज को बदलना ज़्यादा मुश्किल होता है. किसी इमेज को मर्ज करने के लिए, आपको:
- टैग के आकार का आईडी पाएं.
- टैग का साइज़ कॉपी करें और उसकी जानकारी बदलें.
- आकार का उपयोग करके पृष्ठ पर अपनी चित्र जोड़ें, और जानकारी रूपांतरित करें.
- टैग का आकार मिटाएं.
इमेज को मनचाहे साइज़ में स्केल करते समय, उसका आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) बनाए रखने से कुछ देखभाल की ज़रूरत होती है, जैसा कि नीचे सेक्शन में बताया गया है. यह नमूना भी देखें: आकार वाले टैग को इमेज से बदलें.
आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) बनाए रखें
जब Slides API का इस्तेमाल करके इमेज बनाई जाती हैं, तब आसपेक्ट रेशियो सुविधा का इस्तेमाल सिर्फ़
न कि इमेज का साइज़, न कि साइज़ और ट्रांसफ़ॉर्म डेटा. आपका दिया गया साइज़ का डेटा
createImage
में
अनुरोध को इमेज का मनचाहा साइज़ माना जाता है. यह एपीआई,
इमेज की आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को इस मनचाहा साइज़ में बदलें. इसके बाद, दिए गए ट्रांसफ़ॉर्म को लागू करता है.
टैग को इमेज से बदलते समय, इमेज के आसपेक्ट रेशियो को भी बनाए रखें इमेज के साइज़ को सेट करके और स्केलिंग को नीचे बताए गए तरीके से अनुपात तय करें:
- width: टैग के
width
औरscaleX
के प्रॉडक्ट पर सेट किया गया - height: टैग के
height
औरscaleY
के प्रॉडक्ट पर सेट करें - scale_x:
1
पर सेट करें - scale_y:
1
पर सेट करें
इससे Slides API, इमेज की लंबाई-चौड़ाई के हिसाब से
उसका विज़ुअल आकार, उसके गैर-स्केल आकार के बजाय (देखें)
आकार वाले टैग को इमेज से बदलना).
स्केलिंग पैरामीटर को 1
पर सेट करने से, इमेज का साइज़ नहीं बढ़ाया जा सकता
दो बार.
इस तरह से यह पक्का किया जा सकता है कि इमेज का आसपेक्ट रेशियो पहले से मौजूद है. साथ ही, टैग के आकार के आकार से इमेज को बड़ा कर देता है. इमेज में ये शामिल हैं वही केंद्र बिंदु है, जो टैग के आकार के जैसा है.
टेंप्लेट मैनेज करें
टेंप्लेट प्रज़ेंटेशन के लिए यह ऐप्लिकेशन, तय करता है और जिस पर आपका मालिकाना हक है, उसे बनाएं ऐप्लिकेशन की जानकारी देने वाले खाते का इस्तेमाल करके, टेंप्लेट तैयार किया हो. सेवा खाते यह एक अच्छा विकल्प है. साथ ही, इन समस्याओं से बचने के लिए, Google Workspace की उन नीतियों का पालन करें जिनमें शेयर करें.
टेंप्लेट से प्रज़ेंटेशन के इंस्टेंस बनाते समय, हमेशा असली उपयोगकर्ता के क्रेडेंशियल. इससे उपयोगकर्ताओं को नतीजे के तौर पर दिखाया जाता है और हर उपयोगकर्ता से जुड़ी समस्याओं को स्केल करने से रोका जाता है Google Drive में सीमाएं तय करें.
सेवा खाते का इस्तेमाल करके टेंप्लेट बनाने के लिए, यह तरीका अपनाएं ऐप्लिकेशन क्रेडेंशियल:
- Slides API में presentations.create का इस्तेमाल करके प्रज़ेंटेशन बनाएं.
- अनुमतियों को अपडेट करें, ताकि प्रज़ेंटेशन पाने वाले लोग इसे पढ़ सकें Drive API में permissions.create शामिल हैं.
- अनुमतियों को अपडेट करें, ताकि वे इसका इस्तेमाल करके टेंप्लेट लेखकों पर लिख सकें Drive API में permissions.create शामिल हैं.
- ज़रूरत के हिसाब से टेंप्लेट में बदलाव करें.
प्रज़ेंटेशन का इंस्टेंस बनाने के लिए, नीचे दिया गया तरीका अपनाएं इन शर्तों को पूरा करने के लिए:
- का उपयोग करके टेम्प्लेट की एक कॉपी बनाएं files.copy कॉपी करना होगा.
- Slides API में, presentation.batchUpdate का इस्तेमाल करके वैल्यू बदलें.