অনুরোধে প্রদত্ত শিরোনাম ব্যবহার করে একটি খালি প্রেজেন্টেশন তৈরি করে। যদি একটি presentationId প্রদান করা হয়, তবে সেটি নতুন প্রেজেন্টেশনটির আইডি হিসেবে ব্যবহৃত হয়। অন্যথায়, একটি নতুন আইডি তৈরি করা হয়। অনুরোধের অন্যান্য ফিল্ড, প্রদত্ত যেকোনো বিষয়বস্তু সহ, উপেক্ষা করা হয়। তৈরি করা প্রেজেন্টেশনটি ফেরত দেয়।
HTTP অনুরোধ
POST https://slides.googleapis.com/v1/presentations
URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।
অনুরোধকারী শরীর
অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{ "presentationId": string, "pageSize": { object ( |
| ক্ষেত্র | |
|---|---|
presentationId | প্রেজেন্টেশনটির আইডি। |
pageSize | উপস্থাপনার পৃষ্ঠাগুলোর আকার। |
slides[] | প্রেজেন্টেশনের স্লাইডগুলো। একটি স্লাইড তার স্লাইড লেআউট থেকে বৈশিষ্ট্যসমূহ গ্রহণ করে। |
title | উপস্থাপনাটির শিরোনাম। |
masters[] | প্রেজেন্টেশনের স্লাইড মাস্টার। একটি স্লাইড মাস্টারে একগুচ্ছ লেআউটের জন্য সমস্ত সাধারণ পেজ এলিমেন্ট এবং সাধারণ প্রোপার্টিগুলো থাকে। এগুলোর তিনটি উদ্দেশ্য রয়েছে:
|
layouts[] | প্রেজেন্টেশনের লেআউটগুলো। লেআউট হলো একটি টেমপ্লেট যা নির্ধারণ করে, সেই লেআউট থেকে উদ্ভূত স্লাইডগুলোতে বিষয়বস্তু কীভাবে সাজানো এবং স্টাইল করা হবে। |
locale | উপস্থাপনার স্থান, একটি IETF BCP 47 ল্যাঙ্গুয়েজ ট্যাগ হিসেবে। |
revisionId | শুধুমাত্র আউটপুট। প্রেজেন্টেশনটির রিভিশন আইডি। সর্বশেষ রিড অপারেশনের পর প্রেজেন্টেশনটির রিভিশন পরিবর্তিত হয়নি, তা নিশ্চিত করতে আপডেট রিকোয়েস্টে এটি ব্যবহার করা যেতে পারে। শুধুমাত্র তখনই এটি পূরণ করা হয়, যখন ব্যবহারকারীর প্রেজেন্টেশনটি সম্পাদনা করার অ্যাক্সেস থাকে। রিভিশন আইডি কোনো ক্রমিক সংখ্যা নয়, বরং একটি অস্পষ্ট স্ট্রিং। সময়ের সাথে সাথে রিভিশন আইডির ফরম্যাট পরিবর্তিত হতে পারে, তাই এটিকে অস্বচ্ছভাবে বিবেচনা করা উচিত। ফেরত আসা একটি রিভিশন আইডি ফেরত দেওয়ার পর শুধুমাত্র ২৪ ঘণ্টার জন্য বৈধ থাকার নিশ্চয়তা দেয় এবং এটি ব্যবহারকারীদের মধ্যে শেয়ার করা যায় না। যদি কলগুলোর মধ্যে রিভিশন আইডি অপরিবর্তিত থাকে, তাহলে প্রেজেন্টেশনটি পরিবর্তিত হয়নি। বিপরীতভাবে, একটি পরিবর্তিত আইডি (একই প্রেজেন্টেশন এবং ব্যবহারকারীর জন্য) সাধারণত বোঝায় যে প্রেজেন্টেশনটি আপডেট করা হয়েছে। তবে, আইডি ফরম্যাট পরিবর্তনের মতো অভ্যন্তরীণ কারণের জন্যও আইডি পরিবর্তিত হতে পারে। |
notesMaster | উপস্থাপনার নোটগুলো অত্যন্ত গুরুত্বপূর্ণ। এটি তিনটি উদ্দেশ্য পূরণ করে:
নোটস মাস্টারটি শুধুমাত্র পঠনযোগ্য। |
comments[] | শুধুমাত্র আউটপুট। প্রেজেন্টেশনটির সাথে যুক্ত মন্তব্য থ্রেডগুলো। |
commentsViewMode | শুধুমাত্র আউটপুট। প্রেজেন্টেশনটিতে মন্তব্য দেখার মোড প্রয়োগ করা হয়েছে। |
প্রতিক্রিয়া সংস্থা
সফল হলে, রেসপন্স বডিতে Presentation এর একটি নতুন তৈরি করা ইনস্ট্যান্স থাকে।
অনুমোদনের পরিধি
নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.file -
https://www.googleapis.com/auth/presentations
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।