Google Slides API से, आपको Google Slides प्रज़ेंटेशन बनाने और उनमें बदलाव करने की सुविधा मिलती है.
ऐप्लिकेशन को Google Slides API के साथ इंटिग्रेट करके, शानदार स्लाइड डेक बनाए जा सकते हैं उपयोगकर्ता और सिस्टम से मिले डेटा से अपने-आप अपडेट हो जाती है. उदाहरण के लिए, आपके पास ये विकल्प हैं किसी डेटाबेस से ग्राहक की जानकारी का इस्तेमाल कर सकते हैं और उन्हें पहले से डिज़ाइन किए गए तैयार प्रज़ेंटेशन बनाने के लिए टेंप्लेट और चुने गए कॉन्फ़िगरेशन के विकल्पों की जानकारी मैन्युअल तरीके से बनाने में लगने वाले समय का भी हिस्सा है.
एपीआई की खास जानकारी
प्रज़ेंटेशन के कलेक्शन में के तरीके बताए गए हैं जिनकी मदद से प्रज़ेंटेशन में एलिमेंट पाए जा सकते हैं और उन्हें अपडेट किया जा सकता है.
Slides API के साथ आपका ज़्यादातर काम बनाया और अपडेट किया जाता है प्रज़ेंटेशन. ऐसा करने के लिए आपको batchUpdate तरीका; इस तरीके में, ऐप्लिकेशन की अनुरोध करें ऐसी चीज़ें जिनसे आप ये काम कर सकते है:
- स्लाइड बनाएं
- स्लाइड में आकार या टेबल जैसे एलिमेंट जोड़ना
- टेक्स्ट शामिल करना, बदलना, और हटाना
- एलिमेंट में ट्रांसफ़ॉर्म की सुविधा का इस्तेमाल करना
- स्लाइड का क्रम बदलना
ज़्यादा जानकारी के लिए, बैच अपडेट देखें. 'शुरू करें' गाइड देखें पर, एपीआई का इस्तेमाल कैसे किया जाता है.
प्रज़ेंटेशन का स्ट्रक्चर
Slides API में प्रज़ेंटेशन अलग-अलग पेजों का होता है, जिनमें पेज शामिल होता है एलिमेंट.
किसी प्रज़ेंटेशन का आईडी, यूआरएल से लिया जा सकता है:
https://docs.google.com/presentation/d/presentationId/edit
प्रज़ेंटेशन आईडी एक ऐसी स्ट्रिंग होती है जिसमें अक्षर, अंक, और कुछ खास चीज़ें होती हैं वर्ण नीचे दिए गए रेगुलर एक्सप्रेशन का इस्तेमाल करके Google Sheets के यूआरएल से प्रज़ेंटेशन आईडी:
/presentation/d/([a-zA-Z0-9-_]+)
अगर आप Drive API के बारे में जानते हैं, तो presentationId
फ़ाइल का आईडी
संसाधन.
पेज और पेज पर मौजूद एलिमेंट की पहचान, ऑब्जेक्ट आईडी से की जाती है.
Pages
Google Slides में इस तरह के पेज होते हैं:
मास्टर डिग्री | स्लाइड मास्टर की मदद से डिफ़ॉल्ट टेक्स्ट स्टाइल, बैकग्राउंड, और पेज तय किए जा सकते हैं जो इस मास्टर का उपयोग करने वाली सभी स्लाइड में दिखाई देते हैं. पेज सभी स्लाइड पर दिखाए जाने वाले एलिमेंट को मास्टर में जोड़ा जाना चाहिए. ज़्यादातर प्रज़ेंटेशन में एक मास्टर होता है, लेकिन कुछ प्रज़ेंटेशन के लिए कई या कोई भी नहीं होता. |
लेआउट | लेआउट, टेंप्लेट के तौर पर काम करते हैं. इससे पता चलता है कि पेज एलिमेंट को किस तरह व्यवस्थित किया जाएगा डिफ़ॉल्ट विकल्प का इस्तेमाल करें. हर लेआउट एक ऐसेट से जुड़ा होता है मास्टर. |
स्लाइड | इन पेजों में वह कॉन्टेंट मौजूद है जिसे अपनी ऑडियंस को दिखाया जा रहा है. ज़्यादातर स्लाइड मास्टर और लेआउट पर आधारित होती हैं. यह तय किया जा सकता है कि लेआउट चुनें, जिसे हर स्लाइड बनाते समय इस्तेमाल किया जा सके. |
नोट | इन पेजों में, प्रज़ेंटेशन के हैंडआउट का कॉन्टेंट शामिल होता है. एक आकार जिसमें स्लाइड के स्पीकर नोट होते हैं. हर स्लाइड में एक स्लाइड होती है संबंधित नोट पेज. सिर्फ़ प्रज़ेंटर के नोट के आकार में मौजूद टेक्स्ट Slides API की मदद से बदला गया. |
नोट मास्टर | नोट मास्टर, सभी के लिए डिफ़ॉल्ट टेक्स्ट स्टाइल और पेज एलिमेंट तय करते हैं नोट पेज. नोट मास्टर, Slides API में सिर्फ़ पढ़ने के लिए होते हैं. |
पेज एलिमेंट
पेज एलिमेंट, ऐसे विज़ुअल कॉम्पोनेंट होते हैं जो पेजों पर मौजूद होते हैं. एपीआई कई तरह के पेज एलिमेंट दिखाता है:
ग्रुप | पेज एलिमेंट का एक सेट, जिसे एक व्यक्तिगत इकाई माना जाता है. वे ये काम कर सकते हैं किया जा सकता है, बढ़ाया जा सकता है, और घुमाया जा सकता है. |
आकार | एक सादा विज़ुअल ऑब्जेक्ट, जैसे कि रेक्टैंगल, एलिप्स, और टेक्स्ट बॉक्स. आकार में टेक्स्ट हो सकता है, इसलिए वे सबसे ज़्यादा इस्तेमाल किए जाने वाले पेज एलिमेंट होते हैं स्लाइड. |
इमेज | Slides में इंपोर्ट किया गया ग्राफ़िक. |
वीडियो | Slides में इंपोर्ट किया गया वीडियो. |
लाइन | कोई विज़ुअल लाइन, कर्व या कनेक्टर. |
तालिका | कॉन्टेंट का ग्रिड. |
WordArt | विज़ुअल टेक्स्ट एलिमेंट, जो आकार की तरह काम करता है. |
SheetsChart | Google Sheets से Slides में इंपोर्ट किया गया चार्ट. |
बैच अपडेट
batchUpdate तरीका से किसी प्रज़ेंटेशन के कई पहलुओं को अपडेट किया जा सकता है. बदलावों को इसमें एक साथ ग्रुप किया जाता है एक बैच ताकि अगर एक अनुरोध फ़ेल हो जाए, तो दूसरा कोई न हो (संभावित रूप से निर्भर) बदलाव लिखे जाते हैं.
batchUpdate
तरीका काम करने के लिए, एक या इससे ज़्यादा तरीके का इस्तेमाल करता है
अनुरोध करें
ऑब्जेक्ट हैं, जिनमें से हर एक कार्रवाई करने के लिए एक ही तरह के अनुरोध के बारे में बताता है. यहां हैं
अनुरोध भेज सकते हैं. यहां अनुरोधों के टाइप की जानकारी दी गई है.
जो अलग-अलग कैटगरी में बांटे गए हैं.
batchUpdate
तरीका, जवाब का मुख्य हिस्सा दिखाता है,
जिसमें शामिल है
जवाब
. हर जवाब का इंडेक्स,
अनुरोध; उन अनुरोधों के लिए जिनमें कोई लागू प्रतिक्रिया नहीं होती, उस इंडेक्स पर प्रतिक्रिया
खाली रहेगा. अलग-अलग Create
अनुरोधों के जवाब आम तौर पर मिलते हैं, इसलिए
कि आपको जोड़े गए नए ऑब्जेक्ट का आईडी पता है.
ऑब्जेक्ट आईडी के साथ काम करना
Slides API में प्रज़ेंटेशन में पेज और पेज एलिमेंट शामिल होते हैं. इन ऑब्जेक्ट में एक object ID स्ट्रिंग शामिल होती है, जो के साथ अपनी स्क्रीन शेयर करें.
बनाए जाने पर ऑब्जेक्ट आईडी तय करना
URL का उपयोग करके पेज या पेज तत्व बनाते समय batchUpdate तरीका है, तो नए ऑब्जेक्ट के लिए वैकल्पिक रूप से एक ऑब्जेक्ट आईडी तय कर सकता है. इसकी मदद से, ऑब्जेक्ट को कस्टमाइज़ कर सकते हैं और उसी बैचअपडेट अनुरोध में ही उसमें बदलाव कर सकते हैं, कॉल की संख्या और कोटे के इस्तेमाल को कम करना.
ज़्यादातर मामलों में, हमारा सुझाव है कि आप रैंडम ऑब्जेक्ट आईडी जनरेट करें. उदाहरण के लिए, अगर
Java का इस्तेमाल कर रहे हैं, तो java.util.UUID.randomUUID().toString()
ठीक से काम करेगा.
जब आपका ऐप्लिकेशन लंबे समय तक ऑब्जेक्ट को ट्रैक करना चाहता है समय के लिए, ऑब्जेक्ट आईडी पर भरोसा न करें, क्योंकि यह बदल सकता है. नीचे दी गई जानकारी देखें सेक्शन देखें.
ऑब्जेक्ट आईडी का इस्तेमाल किए बिना ऑब्जेक्ट पर नज़र रखना
Slides के एपीआई के लिए अनुरोध करने पर, ऑब्जेक्ट आईडी को आम तौर पर सुरक्षित रखा जाता है. (कोई भी अपवादों के बारे में जानकारी, तरीके के रेफ़रंस दस्तावेज़ में दी गई है.) किसी Drive API के साथ पूरे प्रज़ेंटेशन की कॉपी भी ऑब्जेक्ट आईडी को सुरक्षित रखती है.
हालांकि, प्रज़ेंटेशन के बाद ऑब्जेक्ट आईडी में कोई बदलाव नहीं किया जा सकता Slides के यूज़र इंटरफ़ेस (यूआई) में बदला जाता है. उदाहरण के लिए, अगर कोई व्यक्ति Slides का इस्तेमाल करता है पेज एलिमेंट को कॉपी करके चिपकाने के लिए यूज़र इंटरफ़ेस (यूआई) अब नए यूनीक आईडी का इस्तेमाल किया जाएगा. साथ ही, वह आईडी जिसे आपने एपीआई के ज़रिए पहले उपलब्ध कराया था खो जाएगा. इस वजह से, हम आपको ऑब्जेक्ट आईडी को अपने यहां स्टोर करने का सुझाव नहीं देते ऐप्लिकेशन का स्टोरेज. इसके बजाय, आपको प्रेज़ेंटेशन में टेक्स्ट कॉन्टेंट या वैकल्पिक टेक्स्ट शामिल करें.
नए बनाए गए प्रज़ेंटेशन में डिफ़ॉल्ट रूप से, आईडी के एक जैसे सेट का इस्तेमाल किया जाता है स्लाइड, मास्टर, और टेक्स्ट बॉक्स चुनें. ये आईडी समय के साथ बदल सकते हैं, इसलिए, हमारी सलाह है कि आप इस सुविधा का इस्तेमाल न करें. इसके बजाय, एलिमेंट ढूंढें को कॉल करके लौटाए गए प्रज़ेंटेशन ऑब्जेक्ट का इस्तेमाल करके बदलाव करना है create() या get().