अनुरोध में दिए गए टाइटल का इस्तेमाल करके, एक खाली प्रज़ेंटेशन बनाता है. अगर presentationId
दिया गया है, तो इसका इस्तेमाल नए प्रज़ेंटेशन के आईडी के तौर पर किया जाएगा. ऐसा न करने पर, एक नया आईडी जनरेट हो जाता है. अनुरोध के अन्य फ़ील्ड को नज़रअंदाज़ कर दिया जाता है. इनमें, दिया गया कॉन्टेंट भी शामिल है. बनाया गया प्रज़ेंटेशन दिखाता है.
एचटीटीपी अनुरोध
POST https://slides.googleapis.com/v1/presentations
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "presentationId": string, "pageSize": { object ( |
फ़ील्ड | |
---|---|
presentationId |
प्रज़ेंटेशन का आईडी. |
pageSize |
प्रज़ेंटेशन में पेजों का साइज़. |
slides[] |
प्रज़ेंटेशन में मौजूद स्लाइड. स्लाइड, किसी स्लाइड लेआउट से प्रॉपर्टी इनहेरिट करती है. |
title |
प्रज़ेंटेशन का टाइटल. |
masters[] |
प्रज़ेंटेशन में स्लाइड मास्टर. स्लाइड मास्टर में लेआउट के सेट के लिए सभी सामान्य पेज एलिमेंट और सामान्य प्रॉपर्टी होती हैं. ये तीन मकसद पूरे करते हैं:
|
layouts[] |
प्रज़ेंटेशन में मौजूद लेआउट. लेआउट एक ऐसा टेंप्लेट है जिससे तय होता है कि कॉन्टेंट को कैसे व्यवस्थित किया जाएगा और उस लेआउट से इनहेरिट की गई स्लाइड पर कैसे स्टाइल किया जाएगा. |
locale |
प्रज़ेंटेशन की स्थान-भाषा, जैसे कि आईईटीएफ़ 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
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.