Method: presentations.create

अनुरोध में दिए गए टाइटल का इस्तेमाल करके, एक खाली प्रज़ेंटेशन बनाता है. अगर presentationId दिया गया है, तो इसका इस्तेमाल नए प्रज़ेंटेशन के आईडी के तौर पर किया जाता है. ऐसा न करने पर, एक नया आईडी जनरेट किया जाता है. अनुरोध में मौजूद अन्य फ़ील्ड और दिए गए कॉन्टेंट को अनदेखा कर दिया जाता है. बनाया गया प्रज़ेंटेशन दिखाता है.

एचटीटीपी अनुरोध

POST https://slides.googleapis.com/v1/presentations

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
फ़ील्ड
presentationId

string

प्रज़ेंटेशन का आईडी.
pageSize

object (Size)

प्रज़ेंटेशन में पेजों का साइज़.
slides[]

object (Page)

प्रज़ेंटेशन में मौजूद स्लाइड. स्लाइड, स्लाइड लेआउट से प्रॉपर्टी इनहेरिट करती है.
title

string

प्रज़ेंटेशन का टाइटल.
masters[]

object (Page)

प्रज़ेंटेशन में मौजूद स्लाइड के मास्टर. स्लाइड मास्टर में, लेआउट के सेट के लिए सभी सामान्य पेज एलिमेंट और सामान्य प्रॉपर्टी होती हैं. ये तीन काम करते हैं:

  • किसी मास्टर पर मौजूद प्लेसहोल्डर आकार में, उस मास्टर का इस्तेमाल करने वाले पेजों पर मौजूद सभी प्लेसहोल्डर आकार की डिफ़ॉल्ट टेक्स्ट स्टाइल और आकार प्रॉपर्टी होती हैं.
  • मास्टर्स पेज की प्रॉपर्टी, उन सामान्य पेज प्रॉपर्टी के बारे में बताती हैं जो उसके लेआउट से इनहेरिट की जाती हैं.
  • मास्टर स्लाइड पर मौजूद कोई भी अन्य आकार, उस मास्टर का इस्तेमाल करने वाली सभी स्लाइड पर दिखता है. भले ही, उनका लेआउट कुछ भी हो.
layouts[]

object (Page)

प्रज़ेंटेशन में मौजूद लेआउट. लेआउट एक टेंप्लेट होता है. इससे यह तय होता है कि उस लेआउट से इनहेरिट की गई स्लाइड पर कॉन्टेंट को कैसे व्यवस्थित किया जाता है और उसे किस तरह स्टाइल किया जाता है.
locale

string

आईईटीएफ़ बीसीपी 47 भाषा टैग के तौर पर, प्रज़ेंटेशन की स्थानीय भाषा.
revisionId

string

सिर्फ़ आउटपुट के लिए. प्रज़ेंटेशन का रिविज़न आईडी. अपडेट के अनुरोधों में इसका इस्तेमाल करके यह बताया जा सकता है कि आखिरी बार पढ़ने के बाद, प्रज़ेंटेशन में कोई बदलाव नहीं हुआ है. यह जानकारी सिर्फ़ तब दिखती है, जब उपयोगकर्ता के पास प्रज़ेंटेशन में बदलाव करने का ऐक्सेस हो.

बदलाव का आईडी, क्रम से लगाई गई संख्या नहीं होता, बल्कि यह एक स्ट्रिंग होती है. समय के साथ, बदलाव के आईडी का फ़ॉर्मैट बदल सकता है. इसलिए, इसे सार्वजनिक नहीं किया जाना चाहिए. रिव्यू आईडी वापस मिलने के बाद, यह सिर्फ़ 24 घंटे के लिए मान्य होता है. साथ ही, इसे सभी उपयोगकर्ताओं के साथ शेयर नहीं किया जा सकता. अगर कॉल के बीच में बदलाव का आईडी नहीं बदला है, तो इसका मतलब है कि प्रज़ेंटेशन में कोई बदलाव नहीं हुआ है. इसके उलट, अगर एक ही प्रज़ेंटेशन और उपयोगकर्ता के लिए आईडी बदला गया है, तो इसका मतलब है कि प्रज़ेंटेशन को अपडेट किया गया है. हालांकि, आईडी में बदलाव होने की वजह, आईडी के फ़ॉर्मैट में हुए बदलाव जैसे अंदरूनी फ़ैक्टर भी हो सकते हैं.
notesMaster

object (Page)

प्रज़ेंटेशन में नोट का मास्टर. इसका इस्तेमाल तीन कामों के लिए किया जाता है:

  • नोट मास्टर में मौजूद प्लेसहोल्डर आकार में, notes pages पर मौजूद सभी प्लेसहोल्डर आकार की डिफ़ॉल्ट टेक्स्ट स्टाइल और आकार प्रॉपर्टी होती हैं. खास तौर पर, SLIDE_IMAGE प्लेसहोल्डर आकार में स्लाइड का थंबनेल होता है और BODY प्लेसहोल्डर आकार में स्पीकर नोट होते हैं.
  • नोट की मुख्य पेज प्रॉपर्टी, उन सामान्य पेज प्रॉपर्टी के बारे में बताती हैं जिन्हें सभी notes pages इनहेरिट करते हैं.
  • नोट के मास्टर पर मौजूद अन्य आकार, सभी notes pages पर दिखते हैं.

नोट का मास्टर, रीड-ओनली होता है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Presentation का नया इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.