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

प्रज़ेंटेशन की स्थान-भाषा, IETF BCP 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

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