Google Slides API আপনাকে Google Slides উপস্থাপনা তৈরি এবং সংশোধন করতে দেয়।
ব্যবহারকারী এবং সিস্টেম-প্রদত্ত ডেটা থেকে স্বয়ংক্রিয়ভাবে সুন্দর স্লাইড ডেক তৈরি করতে অ্যাপগুলি Google Slides API-এর সাথে একীভূত হতে পারে। উদাহরণস্বরূপ, আপনি একটি ডাটাবেস থেকে গ্রাহকের বিবরণ ব্যবহার করতে পারেন এবং সেগুলিকে পূর্বনির্ধারিত টেমপ্লেট এবং নির্বাচিত কনফিগারেশন বিকল্পগুলির সাথে একত্রিত করে ম্যানুয়ালি তৈরি করতে যে সময় লাগে তার একটি ভগ্নাংশের মধ্যে সমাপ্ত উপস্থাপনা তৈরি করতে পারেন।
API এর সংক্ষিপ্তসার
উপস্থাপনা সংগ্রহ এমন পদ্ধতি প্রদান করে যা আপনাকে উপস্থাপনার মধ্যে উপাদানগুলি পেতে এবং আপডেট করতে দেয়।
Slides API ব্যবহার করে আপনার বেশিরভাগ কাজ সম্ভবত উপস্থাপনা তৈরি এবং আপডেট করা হবে। আপনি batchUpdate পদ্ধতি ব্যবহার করে এটি করবেন; এই পদ্ধতিতে Request অবজেক্টের একটি তালিকা থাকে যা আপনাকে নিম্নলিখিত কাজগুলি করতে দেয়:
- স্লাইড তৈরি করুন
- স্লাইডে উপাদান যোগ করুন, যেমন আকার বা টেবিল
- টেক্সট সন্নিবেশ করান, পরিবর্তন করুন এবং সরান
- উপাদানগুলিতে রূপান্তর প্রয়োগ করুন
- স্লাইডের ক্রম পরিবর্তন করুন
আরও বিস্তারিত জানার জন্য ব্যাচ আপডেট দেখুন। API কীভাবে ব্যবহার করবেন তার একটি সহজ এন্ড-টু-এন্ড উদাহরণের জন্য শুরু করুন নির্দেশিকাগুলি দেখুন।
একটি উপস্থাপনার কাঠামো
স্লাইডস এপিআই-তে একটি উপস্থাপনা পৃষ্ঠাগুলি দিয়ে তৈরি, যাতে পৃষ্ঠার উপাদান থাকে।
একটি উপস্থাপনার আইডি URL থেকে নেওয়া যেতে পারে:
https://docs.google.com/presentation/d/presentationId/edit
প্রেজেন্টেশন আইডি হল একটি স্ট্রিং যাতে অক্ষর, সংখ্যা এবং কিছু বিশেষ অক্ষর থাকে। নিম্নলিখিত রেগুলার এক্সপ্রেশনটি ব্যবহার করে গুগল শিটস ইউআরএল থেকে প্রেজেন্টেশন আইডি বের করা যেতে পারে:
/presentation/d/([a-zA-Z0-9-_]+)
যদি আপনি ড্রাইভ এপিআই এর সাথে পরিচিত হন, তাহলে presentationId ফাইল রিসোর্সের আইডির সাথে মিলে যায়।
পৃষ্ঠা এবং পৃষ্ঠার উপাদানগুলি অবজেক্ট আইডি দ্বারা চিহ্নিত করা হয়।
পাতা
গুগল স্লাইডে নিম্নলিখিত ধরণের পৃষ্ঠা রয়েছে:
| মাস্টার্স | স্লাইড মাস্টাররা এই মাস্টার ব্যবহার করে এমন সমস্ত স্লাইডে প্রদর্শিত ডিফল্ট টেক্সট স্টাইল, ব্যাকগ্রাউন্ড এবং পৃষ্ঠা উপাদানগুলিকে সংজ্ঞায়িত করে। সমস্ত স্লাইডে প্রদর্শিত পৃষ্ঠা উপাদানগুলিকে মাস্টারে যোগ করা উচিত। বেশিরভাগ উপস্থাপনার একটি মাস্টার থাকে, তবে কিছুতে একাধিক বা কোনওটিই নাও থাকতে পারে। |
| লেআউট | লেআউট ব্যবহার করে স্লাইডে ডিফল্টভাবে পৃষ্ঠা উপাদানগুলি কীভাবে সাজানো হবে তার জন্য লেআউটগুলি একটি টেমপ্লেট হিসেবে কাজ করে। প্রতিটি লেআউট একজন মাস্টারের সাথে যুক্ত। |
| স্লাইড | এই পৃষ্ঠাগুলিতে আপনার দর্শকদের সামনে উপস্থাপন করা সামগ্রী থাকে। বেশিরভাগ স্লাইড একটি মাস্টার এবং একটি লেআউটের উপর ভিত্তি করে তৈরি হয়। প্রতিটি স্লাইড তৈরি করার সময় কোন লেআউট ব্যবহার করবেন তা আপনি নির্দিষ্ট করতে পারেন। |
| মন্তব্য | এই পৃষ্ঠাগুলিতে উপস্থাপনা হ্যান্ডআউটের জন্য সামগ্রী রয়েছে, যার মধ্যে একটি আকৃতি রয়েছে যাতে স্লাইডের স্পিকার নোট রয়েছে। প্রতিটি স্লাইডে একটি সংশ্লিষ্ট নোট পৃষ্ঠা রয়েছে। স্লাইড API ব্যবহার করে শুধুমাত্র স্পিকার নোট আকারের পাঠ্য পরিবর্তন করা যেতে পারে। |
| নোট মাস্টার | নোটস মাস্টারগুলি সমস্ত নোট পৃষ্ঠার জন্য ডিফল্ট টেক্সট স্টাইল এবং পৃষ্ঠা উপাদান সংজ্ঞায়িত করে। স্লাইডস API-তে নোটস মাস্টারগুলি কেবল পঠনযোগ্য। |
পৃষ্ঠার উপাদান
পৃষ্ঠা উপাদান হল ভিজ্যুয়াল উপাদান যা পৃষ্ঠাগুলিতে স্থাপন করা হয়। API বিভিন্ন ধরণের পৃষ্ঠা উপাদান প্রকাশ করে:
| গ্রুপ | পৃষ্ঠার উপাদানগুলির একটি সেট যা একটি পৃথক ইউনিট হিসাবে বিবেচিত হয়। এগুলি একসাথে সরানো, স্কেল করা এবং ঘোরানো যেতে পারে। |
| আকৃতি | একটি সরল দৃশ্যমান বস্তু, যেমন আয়তক্ষেত্র, উপবৃত্ত এবং টেক্সট বাক্স। আকারগুলিতে টেক্সট থাকতে পারে, তাই স্লাইড তৈরির জন্য এগুলিই সবচেয়ে সাধারণ পৃষ্ঠা উপাদান। |
| ভাবমূর্তি | স্লাইডে আমদানি করা একটি গ্রাফিক। |
| ভিডিও | স্লাইডে ইম্পোর্ট করা একটি ভিডিও। |
| লাইন | একটি দৃশ্যমান রেখা, বক্ররেখা, অথবা সংযোগকারী। |
| টেবিল | কন্টেন্টের একটি গ্রিড। |
| ওয়ার্ডআর্ট | একটি ভিজ্যুয়াল টেক্সট উপাদান যা অনেকটা আকৃতির মতো আচরণ করে। |
| শীটচার্ট | Google Sheets থেকে স্লাইডে আমদানি করা একটি চার্ট। |
ব্যাচ আপডেট
batchUpdate পদ্ধতি আপনাকে একটি উপস্থাপনার অনেক দিক আপডেট করতে দেয়। পরিবর্তনগুলিকে একটি ব্যাচে একত্রিত করা হয় যাতে একটি অনুরোধ ব্যর্থ হলে, অন্য কোনও (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তন লেখা না হয়।
batchUpdate পদ্ধতিটি এক বা একাধিক Request অবজেক্ট নিয়ে কাজ করে, প্রতিটি অবজেক্ট এক ধরণের অনুরোধ সম্পাদনের জন্য নির্দিষ্ট করে। অনেক ধরণের অনুরোধ রয়েছে। এখানে বিভিন্ন ধরণের অনুরোধের একটি তালিকা দেওয়া হল, যা বিভিন্ন বিভাগে ভাগ করা হয়েছে।
batchUpdate পদ্ধতিটি একটি রেসপন্স বডি প্রদান করে, যেখানে প্রতিটি অনুরোধের জন্য একটি রেসপন্স থাকে। প্রতিটি রেসপন্স সংশ্লিষ্ট অনুরোধের মতো একই সূচী ধারণ করে; প্রযোজ্য কোনও রেসপন্স না থাকা অনুরোধের জন্য, সেই সূচীতে রেসপন্স খালি থাকবে। বিভিন্ন Create অনুরোধগুলিতে সাধারণত রেসপন্স থাকে, যাতে আপনি নতুন যোগ করা অবজেক্টের আইডি জানতে পারেন।
অবজেক্ট আইডি নিয়ে কাজ করা
স্লাইডস এপিআই-তে একটি উপস্থাপনা পৃষ্ঠা এবং পৃষ্ঠা উপাদান দিয়ে তৈরি। এই অবজেক্টগুলিতে একটি অবজেক্ট আইডি স্ট্রিং থাকে যা একটি উপস্থাপনার মধ্যে অনন্য।
তৈরিতে অবজেক্ট আইডি নির্দিষ্ট করা
batchUpdate পদ্ধতি ব্যবহার করে পৃষ্ঠা বা পৃষ্ঠা উপাদান তৈরি করার সময়, আপনি ঐচ্ছিকভাবে নতুন বস্তুর জন্য একটি বস্তু ID নির্দিষ্ট করতে পারেন। এটি আপনাকে একটি বস্তু তৈরি করতে এবং একই batchUpdate অনুরোধের মধ্যে এটি পরিবর্তন করতে দেয়, Slides API-তে কলের সংখ্যা কমিয়ে দেয় এবং
কোটা ব্যবহার ।
আমরা বেশিরভাগ ক্ষেত্রেই একটি র্যান্ডম অবজেক্ট আইডি তৈরি করার পরামর্শ দিই। উদাহরণস্বরূপ, যদি আপনি জাভা ব্যবহার করেন, তাহলে java.util.UUID.randomUUID().toString() ভালোভাবে কাজ করবে।
যখন আপনার অ্যাপ্লিকেশনটি দীর্ঘ সময় ধরে অবজেক্টের ট্র্যাক রাখতে চায়, তখন অবজেক্ট আইডির উপর নির্ভর করবেন না, কারণ এটি পরিবর্তিত হতে পারে। আরও বিস্তারিত জানার জন্য নিম্নলিখিত বিভাগটি দেখুন।
অবজেক্ট আইডি ব্যবহার না করেই অবজেক্টের ট্র্যাক রাখা
যখন আপনি একটি Slides API অনুরোধ করেন, তখন অবজেক্ট আইডি সাধারণত সংরক্ষিত থাকে। (যেকোন ব্যতিক্রম পদ্ধতির রেফারেন্স ডকুমেন্টেশনে উল্লেখ করা হয়।) ড্রাইভ API ব্যবহার করে একটি সম্পূর্ণ উপস্থাপনার একটি অনুলিপি তৈরি করলেও অবজেক্ট আইডি সংরক্ষণ করা হয়।
তবে, স্লাইডস UI-তে উপস্থাপনা পরিবর্তন করার পরে কোনও অবজেক্ট আইডি অপরিবর্তিত থাকার উপর নির্ভর করা যাবে না। উদাহরণস্বরূপ, যদি কেউ স্লাইডস UI ব্যবহার করে কোনও পৃষ্ঠা উপাদান কপি-পেস্ট করে এবং তারপর মূলটি মুছে ফেলে, তাহলে পৃষ্ঠা উপাদানটির এখন একটি নতুন অনন্য আইডি থাকবে এবং API-এর মাধ্যমে আপনি পূর্বে যে আইডিটি দিয়েছিলেন তা হারিয়ে যাবে। ফলস্বরূপ, আমরা আপনাকে আপনার অ্যাপ্লিকেশনের স্টোরেজে অবজেক্ট আইডি সংরক্ষণ করার পরামর্শ দিচ্ছি না। পরিবর্তে, আপনার উপস্থাপনায় অবজেক্টগুলি তার পাঠ্য সামগ্রী বা অল্ট-টেক্সট অনুসারে খুঁজে পাওয়া উচিত।
নতুন তৈরি উপস্থাপনাগুলি সাধারণত ডিফল্ট স্লাইড, মাস্টার এবং টেক্সট বক্সের জন্য ধারাবাহিক আইডি সেট ব্যবহার করে। এই আইডিগুলি সময়ের সাথে সাথে পরিবর্তিত হতে পারে, তাই আমরা আপনাকে এই বৈশিষ্ট্যের উপর নির্ভর করার পরামর্শ দিচ্ছি না। পরিবর্তে, create() বা get() কল দ্বারা প্রেজেন্টেশন অবজেক্ট ব্যবহার করে আপনি যে উপাদানগুলি পরিবর্তন করতে চান তা খুঁজুন।