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

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

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