शुरुआती जानकारी

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 फ़ाइल संसाधन के आईडी से मेल खाता है.

पेजों और पेज एलिमेंट की पहचान, ऑब्जेक्ट आईडी से की जाती है.

पेज

Google Slides में इस तरह के पेज होते हैं:

पेज एलिमेंट

पेज एलिमेंट, पेजों पर डाले जाने वाले विज़ुअल कॉम्पोनेंट होते हैं. एपीआई, कई तरह के पेज एलिमेंट दिखाता है:

एक साथ कई अपडेट करना

batchUpdate तरीके की मदद से, प्रज़ेंटेशन के कई हिस्सों को अपडेट किया जा सकता है. बदलावों को एक ग्रुप में रखा जाता है, ताकि अगर एक अनुरोध पूरा न हो पाए, तो दूसरे (संभावित रूप से डिपेंडेंट) बदलावों को भी न लिखा जाए.

batchUpdate तरीका, एक या एक से ज़्यादा Request ऑब्जेक्ट लेकर काम करता है. हर ऑब्जेक्ट, एक तरह के अनुरोध के बारे में बताता है. कई तरह के अनुरोध होते हैं. यहां अलग-अलग कैटगरी में बांटकर, अनुरोधों के टाइप के बारे में जानकारी दी गई है.

batchUpdate तरीका, जवाब का मुख्य हिस्सा दिखाता है. इसमें हर अनुरोध के लिए, जवाब होता है. हर रिस्पॉन्स, उससे जुड़े अनुरोध के इंडेक्स में होता है. जिन अनुरोधों के लिए कोई रिस्पॉन्स लागू नहीं होता उनके इंडेक्स में रिस्पॉन्स खाली होगा. आम तौर पर, अलग-अलग Create अनुरोधों के जवाब मिलते हैं, ताकि आपको नए जोड़े गए ऑब्जेक्ट का आईडी पता चल सके.

ऑब्जेक्ट आईडी के साथ काम करना

Slides API में मौजूद प्रज़ेंटेशन, पेजों और पेज एलिमेंट से बना होता है. इन ऑब्जेक्ट में एक ऑब्जेक्ट आईडी स्ट्रिंग शामिल होती है, जो किसी प्रज़ेंटेशन में यूनीक होती है.

ऑब्जेक्ट बनाते समय ऑब्जेक्ट आईडी तय करना

batchUpdate के तरीके का इस्तेमाल करके पेज या पेज एलिमेंट बनाते समय, नए ऑब्जेक्ट के लिए ऑब्जेक्ट आईडी दिया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. इससे, एक ही बैच अपडेट रिक्वेस्ट में ऑब्जेक्ट बनाया जा सकता है और उसमें बदलाव किया जा सकता है. इससे, Slides API को किए जाने वाले कॉल की संख्या कम हो जाती है और
कोटा के इस्तेमाल को कम किया जा सकता है.

हमारा सुझाव है कि ज़्यादातर मामलों में कोई रैंडम ऑब्जेक्ट आईडी जनरेट करें. उदाहरण के लिए, अगर Java का इस्तेमाल किया जा रहा है, तो java.util.UUID.randomUUID().toString() ठीक से काम करेगा.

अगर आपका ऐप्लिकेशन लंबे समय तक ऑब्जेक्ट का ट्रैक रखना चाहता है, तो ऑब्जेक्ट आईडी पर भरोसा न करें, क्योंकि यह बदल सकता है. ज़्यादा जानकारी के लिए, यहां मौजूद सेक्शन देखें.

ऑब्जेक्ट आईडी का इस्तेमाल किए बिना ऑब्जेक्ट का ट्रैक रखना

Slides API का अनुरोध करने पर, आम तौर पर ऑब्जेक्ट आईडी को सुरक्षित रखा जाता है. (किसी भी अपवाद को, तरीके के रेफ़रंस दस्तावेज़ में बताया गया है.) Drive API की मदद से पूरे प्रज़ेंटेशन की कॉपी बनाने पर भी, ऑब्जेक्ट आईडी सुरक्षित रहते हैं.

हालांकि, Slides के यूज़र इंटरफ़ेस (यूआई) में प्रज़ेंटेशन में बदलाव करने के बाद, ऑब्जेक्ट आईडी में बदलाव न होने की उम्मीद नहीं की जा सकती. उदाहरण के लिए, अगर कोई व्यक्ति किसी पेज एलिमेंट को कॉपी-पेस्ट करने के लिए Slides के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करता है और फिर ओरिजनल एलिमेंट को मिटा देता है, तो पेज एलिमेंट का एक नया यूनीक आईडी होगा. साथ ही, एपीआई के ज़रिए पहले जो आईडी दिया गया था वह मिट जाएगा. इसलिए, हमारा सुझाव है कि आप अपने ऐप्लिकेशन के स्टोरेज में ऑब्जेक्ट आईडी सेव न करें. इसके बजाय, आपको प्रज़ेंटेशन में टेक्स्ट कॉन्टेंट या वैकल्पिक टेक्स्ट के हिसाब से ऑब्जेक्ट ढूंढने चाहिए.

आम तौर पर, नई प्रज़ेंटेशन में डिफ़ॉल्ट स्लाइड, मास्टर्स, और टेक्स्ट बॉक्स के लिए आईडी के एक जैसे सेट का इस्तेमाल किया जाता है. ये आईडी समय के साथ बदल सकते हैं. इसलिए, हमारा सुझाव है कि आप इस सुविधा पर भरोसा न करें. इसके बजाय, create() या get() कॉल से दिखाए गए ऑब्जेक्ट का इस्तेमाल करके, वे एलिमेंट ढूंढें जिनमें आपको बदलाव करना है.