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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
फ़ील्ड
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 पर दिखते हैं.

नोट मास्टर को सिर्फ़ पढ़ा जा सकता है.
comments[]

object (CommentThread)

सिर्फ़ आउटपुट के लिए. प्रज़ेंटेशन से जुड़ी टिप्पणियों की थ्रेड.
commentsViewMode

enum (CommentsViewMode)

सिर्फ़ आउटपुट के लिए. प्रज़ेंटेशन पर लागू किया गया टिप्पणियां देखने का मोड.

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

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

अनुमति पाने के लिंक

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

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

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