अनुरोध में दिए गए टाइटल का इस्तेमाल करके, खाली प्रज़ेंटेशन बनाता है. अगर presentationId
दिया गया है, तो उसका इस्तेमाल नए प्रज़ेंटेशन के आईडी के तौर पर किया जाएगा. ऐसा न करने पर, एक नया आईडी जनरेट हो जाता है. अनुरोध के अन्य फ़ील्ड को अनदेखा कर दिया जाता है. इनमें, उपलब्ध कराया गया कॉन्टेंट भी शामिल होता है. बनाया गया प्रज़ेंटेशन दिखाता है.
एचटीटीपी अनुरोध
POST https://slides.googleapis.com/v1/presentations
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ "presentationId": string, "pageSize": { object ( |
फ़ील्ड | |
---|---|
presentationId |
प्रज़ेंटेशन का आईडी. |
pageSize |
प्रज़ेंटेशन में पेजों का साइज़. |
slides[] |
प्रज़ेंटेशन में मौजूद स्लाइड. स्लाइड, स्लाइड लेआउट से प्रॉपर्टी इनहेरिट करती है. |
title |
प्रज़ेंटेशन का टाइटल. |
masters[] |
प्रज़ेंटेशन में मौजूद स्लाइड मास्टर. स्लाइड मास्टर में सभी सामान्य पेज एलिमेंट और लेआउट के सेट की सामान्य प्रॉपर्टी होती हैं. ये तीन मकसद पूरे करते हैं:
|
layouts[] |
प्रज़ेंटेशन में लेआउट. लेआउट एक टेंप्लेट है, जो तय करता है कि उस लेआउट से इनहेरिट की जाने वाली स्लाइड पर कॉन्टेंट को कैसे व्यवस्थित किया जाए और उसकी स्टाइल कैसे की जाए. |
locale |
प्रज़ेंटेशन की स्थान-भाषा, IETF BCP 47 भाषा टैग के तौर पर. |
revisionId |
सिर्फ़ आउटपुट के लिए. प्रज़ेंटेशन का रिविज़न आईडी. इसका इस्तेमाल अपडेट के अनुरोधों में यह दावा करने के लिए किया जा सकता है कि पिछली बार पढ़े गए बदलाव के बाद से, प्रज़ेंटेशन में किया गया बदलाव नहीं बदला है. प्रज़ेंटेशन में बदलाव करने का ऐक्सेस होने पर ही, जानकारी अपने-आप भर जाती है. संशोधन आईडी कोई क्रमिक संख्या नहीं, बल्कि एक नेबुलस स्ट्रिंग है. संशोधन आईडी का प्रारूप समय के साथ बदल सकता है, इसलिए इसे अपारदर्शी माना जाना चाहिए. इस बात की गारंटी है कि वापस किया गया वर्शन आईडी, वापस करने के 24 घंटे बाद तक ही मान्य रहेगा. साथ ही, इसे अन्य उपयोगकर्ताओं के साथ शेयर नहीं किया जा सकता. अगर कॉल के बीच रिविज़न आईडी में कोई बदलाव नहीं होता है, तो इसका मतलब है कि प्रज़ेंटेशन में बदलाव नहीं हुआ है. इसके उलट, एक ही प्रज़ेंटेशन और उपयोगकर्ता के लिए बदले गए आईडी का मतलब है कि प्रज़ेंटेशन को अपडेट कर दिया गया है. हालांकि, आईडी फ़ॉर्मैट में बदलाव जैसी अंदरूनी वजहों से भी आईडी बदल सकता है. |
notesMaster |
प्रज़ेंटेशन में नोट मास्टर. इसके तीन मकसद हैं:
नोट मास्टर को सिर्फ़ पढ़ा जा सकता है. |
जवाब का मुख्य भाग
कामयाब होने पर, जवाब के मुख्य हिस्से में Presentation
का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.