ভূমিকা

Google স্লাইড API আপনাকে Google স্লাইড উপস্থাপনা তৈরি এবং সংশোধন করতে দেয়৷

ব্যবহারকারী- এবং সিস্টেম-প্রদত্ত ডেটা থেকে স্বয়ংক্রিয়ভাবে সুন্দর স্লাইড ডেক তৈরি করতে অ্যাপগুলি Google স্লাইড API-এর সাথে একীভূত হতে পারে। উদাহরণস্বরূপ, আপনি একটি ডাটাবেস থেকে গ্রাহকের বিশদ ব্যবহার করতে পারেন এবং সেগুলিকে ম্যানুয়ালি তৈরি করতে সময়ের একটি ভগ্নাংশে সমাপ্ত উপস্থাপনা তৈরি করতে পূর্বনির্ধারিত টেমপ্লেট এবং নির্বাচিত কনফিগারেশন বিকল্পগুলির সাথে একত্রিত করতে পারেন।

API এর ওভারভিউ

উপস্থাপনা সংগ্রহ পদ্ধতিগুলি প্রদান করে যা আপনাকে উপস্থাপনার মধ্যে উপাদানগুলি পেতে এবং আপডেট করতে দেয়।

স্লাইড এপিআই এর সাথে আপনার বেশিরভাগ কাজ সম্ভবত উপস্থাপনা তৈরি এবং আপডেট করা হবে। আপনি batchUpdate পদ্ধতি ব্যবহার করে এটি করবেন; এই পদ্ধতিটি অনুরোধ বস্তুর একটি তালিকা নেয় যা আপনাকে কিছু করতে দেয়:

  • স্লাইড তৈরি করুন
  • স্লাইডে উপাদান যোগ করুন যেমন আকার বা টেবিল
  • টেক্সট ঢোকান, পরিবর্তন করুন এবং সরান
  • উপাদানে রূপান্তর প্রয়োগ করুন
  • স্লাইডের ক্রম পরিবর্তন করুন

আরো বিস্তারিত জানার জন্য ব্যাচ আপডেট দেখুন. কিভাবে API ব্যবহার করতে হয় তার একটি সহজ এন্ড-টু-এন্ড উদাহরণের জন্য শুরু করুন গাইড দেখুন।

একটি উপস্থাপনা গঠন

স্লাইড এপিআই-এ একটি উপস্থাপনা পৃষ্ঠাগুলি নিয়ে গঠিত, যেটিতে পৃষ্ঠার উপাদান রয়েছে৷

একটি উপস্থাপনার ID URL থেকে প্রাপ্ত করা যেতে পারে:

https://docs.google.com/presentation/d/presentationId/edit

উপস্থাপনা ID হল একটি স্ট্রিং যাতে অক্ষর, সংখ্যা এবং কিছু বিশেষ অক্ষর থাকে। একটি Google পত্রক URL থেকে উপস্থাপনা ID বের করতে নিম্নলিখিত নিয়মিত অভিব্যক্তি ব্যবহার করা যেতে পারে:

/presentation/d/([a-zA-Z0-9-_]+)

আপনি যদি ড্রাইভ API-এর সাথে পরিচিত হন, তাহলে presentationId ফাইল সংস্থানের আইডির সাথে মিলে যায়।

পৃষ্ঠা এবং পৃষ্ঠা উপাদানগুলি অবজেক্ট আইডি দ্বারা চিহ্নিত করা হয়।

পাতা

Google স্লাইডের নিম্নলিখিত ধরণের পৃষ্ঠা রয়েছে:

মাস্টার্স স্লাইড মাস্টারগুলি ডিফল্ট পাঠ্য শৈলী, পটভূমি এবং পৃষ্ঠা উপাদানগুলিকে সংজ্ঞায়িত করে যা এই মাস্টার ব্যবহার করে এমন সমস্ত স্লাইডে উপস্থিত হয়৷ সমস্ত স্লাইডে উপস্থিত হওয়া আবশ্যক পৃষ্ঠা উপাদানগুলি মাস্টারে যোগ করা উচিত। বেশিরভাগ উপস্থাপনায় একটি মাস্টার আছে, কিন্তু কিছু কিছু একাধিক বা কোনোটিই থাকতে পারে।
বিন্যাস লেআউটগুলি লেআউট ব্যবহার করে স্লাইডে ডিফল্টরূপে পৃষ্ঠা উপাদানগুলি কীভাবে সাজানো হবে তার জন্য একটি টেমপ্লেট হিসাবে কাজ করে। প্রতিটি লেআউট এক মাস্টারের সাথে যুক্ত।
স্লাইড এই পৃষ্ঠাগুলিতে আপনি আপনার শ্রোতাদের কাছে উপস্থাপন করছেন এমন সামগ্রী রয়েছে৷ বেশিরভাগ স্লাইড একটি মাস্টার এবং একটি লেআউটের উপর ভিত্তি করে। প্রতিটি স্লাইড তৈরি করার সময় কোন লেআউট ব্যবহার করতে হবে তা আপনি নির্দিষ্ট করতে পারেন।
নোট এই পৃষ্ঠাগুলিতে উপস্থাপনা হ্যান্ডআউটের বিষয়বস্তু রয়েছে, যার মধ্যে একটি আকৃতি রয়েছে যাতে স্লাইডের স্পিকার নোট রয়েছে। প্রতিটি স্লাইডে একটি সংশ্লিষ্ট নোট পৃষ্ঠা রয়েছে। স্লাইডস এপিআই দিয়ে শুধুমাত্র স্পিকার নোটের আকারের পাঠ্য পরিবর্তন করা যেতে পারে।
নোট মাস্টার নোট মাস্টাররা সমস্ত নোট পৃষ্ঠাগুলির জন্য ডিফল্ট পাঠ্য শৈলী এবং পৃষ্ঠা উপাদানগুলি সংজ্ঞায়িত করে। নোট মাস্টারগুলি স্লাইড এপিআই-এ শুধুমাত্র পঠনযোগ্য।

পৃষ্ঠা উপাদান

পৃষ্ঠা উপাদানগুলি হল চাক্ষুষ উপাদান যা পৃষ্ঠাগুলিতে স্থাপন করা হয়। API বিভিন্ন ধরণের পৃষ্ঠা উপাদান প্রকাশ করে:

গ্রুপ পৃষ্ঠা উপাদানগুলির একটি সেট যা একটি পৃথক ইউনিট হিসাবে বিবেচিত হয়। এগুলি একসাথে সরানো, স্কেল করা এবং ঘোরানো যায়।
আকৃতি একটি সরল চাক্ষুষ বস্তু, যেমন আয়তক্ষেত্র, উপবৃত্ত এবং পাঠ্য বাক্স। আকারে পাঠ্য থাকতে পারে, তাই স্লাইডগুলি তৈরি করার জন্য এগুলি সবচেয়ে সাধারণ পৃষ্ঠা উপাদান।
ছবি একটি গ্রাফিক স্লাইডে আমদানি করা হয়েছে৷
ভিডিও একটি ভিডিও স্লাইডে আমদানি করা হয়েছে৷
লাইন একটি ভিজ্যুয়াল লাইন, বক্ররেখা বা সংযোগকারী।
টেবিল বিষয়বস্তুর একটি গ্রিড।
ওয়ার্ডআর্ট একটি ভিজ্যুয়াল টেক্সট উপাদান যা আকৃতির মতো আচরণ করে।
শীটচার্ট Google পত্রক থেকে স্লাইডে আমদানি করা একটি চার্ট৷

ব্যাচ আপডেট

ব্যাচআপডেট পদ্ধতি আপনাকে উপস্থাপনার অনেক দিক আপডেট করতে দেয়। পরিবর্তনগুলিকে একটি ব্যাচে একসাথে গোষ্ঠীভুক্ত করা হয় যাতে একটি অনুরোধ ব্যর্থ হলে, অন্য কোনটি (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তনগুলি লেখা হয় না৷

batchUpdate পদ্ধতি এক বা একাধিক রিকোয়েস্ট অবজেক্ট গ্রহণ করে কাজ করে, প্রত্যেকে একক ধরনের রিকোয়েস্ট নির্দিষ্ট করে। বিভিন্ন ধরণের অনুরোধ রয়েছে। এখানে অনুরোধের ধরনের একটি ব্রেকডাউন, বিভিন্ন বিভাগে গোষ্ঠীবদ্ধ।

স্লাইডের সাথে কাজ করা: স্লাইড অনুরোধ তৈরি করুন
UpdateSlidesPositionRequest
ডুপ্লিকেট অবজেক্ট রিকোয়েস্ট
UpdatePagePropertiesRequest
অবজেক্ট রিকোয়েস্ট ডিলিট করুন
পৃষ্ঠা উপাদানগুলির সাথে কাজ করা: আকৃতির অনুরোধ তৈরি করুন
লাইন রিকোয়েস্ট তৈরি করুন
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
ডুপ্লিকেট অবজেক্ট রিকোয়েস্ট
অবজেক্ট রিকোয়েস্ট ডিলিট করুন
টেবিলের সাথে কাজ করা: টেবল অনুরোধ তৈরি করুন
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
আপডেট টেবিল বর্ডার প্রোপার্টিজ অনুরোধ
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
অবজেক্ট রিকোয়েস্ট ডিলিট করুন
চার্ট নিয়ে কাজ করা: SheetsChartRequest তৈরি করুন
RefreshSheetsChartRequest
AllShapesWithSheetsChartRequest প্রতিস্থাপন করুন
অবজেক্ট রিকোয়েস্ট ডিলিট করুন
ছবি এবং ভিডিও নিয়ে কাজ করা: ইমেজ রিকোয়েস্ট তৈরি করুন
ভিডিও অনুরোধ তৈরি করুন
UpdateImagePropertiesRequest
ভিডিও বৈশিষ্ট্য আপডেট করুন
AllShapesWithImageRequest প্রতিস্থাপন করুন
ডুপ্লিকেট অবজেক্ট রিকোয়েস্ট
অবজেক্ট রিকোয়েস্ট ডিলিট করুন
পাঠ্যের সাথে কাজ করা: InsertTextRequest
DeleteTextRequest
AllTextRequest প্রতিস্থাপন করুন
ParagraphBulletsRequest তৈরি করুন
অনুচ্ছেদ মুছুন বুলেট অনুরোধ
UpdateTextStyleRequest
অনুচ্ছেদশৈলীর অনুরোধ আপডেট করুন

batchUpdate পদ্ধতি একটি প্রতিক্রিয়া বডি প্রদান করে, যাতে প্রতিটি অনুরোধের জন্য একটি প্রতিক্রিয়া থাকে। প্রতিটি প্রতিক্রিয়া সংশ্লিষ্ট অনুরোধের মতো একই সূচক দখল করে; কোন প্রযোজ্য প্রতিক্রিয়া ছাড়া অনুরোধের জন্য, সেই সূচকে প্রতিক্রিয়া খালি হবে। বিভিন্ন Create রিকোয়েস্টের সাধারনত প্রতিক্রিয়া থাকে, যাতে আপনি নতুন যোগ করা বস্তুর আইডি জানেন।

অবজেক্ট আইডি নিয়ে কাজ করা

স্লাইড এপিআই-এর একটি উপস্থাপনা পৃষ্ঠা এবং পৃষ্ঠার উপাদানগুলির সমন্বয়ে গঠিত। এই অবজেক্টগুলির মধ্যে একটি অবজেক্ট আইডি স্ট্রিং রয়েছে যা একটি উপস্থাপনার মধ্যে অনন্য।

সৃষ্টিতে অবজেক্ট আইডি নির্দিষ্ট করা

ব্যাচআপডেট পদ্ধতি ব্যবহার করে পৃষ্ঠা বা পৃষ্ঠা উপাদান তৈরি করার সময়, আপনি নতুন অবজেক্টের জন্য ঐচ্ছিকভাবে একটি অবজেক্ট আইডি নির্দিষ্ট করতে পারেন। এটি আপনাকে একটি বস্তু তৈরি করতে এবং একই ব্যাচআপডেট অনুরোধের মধ্যে এটিকে সংশোধন করতে দেয়, স্লাইড এপিআই-এ কলের সংখ্যা কমিয়ে এবং কোটা ব্যবহার হ্রাস করে।

আমরা বেশিরভাগ ক্ষেত্রে একটি র্যান্ডম অবজেক্ট আইডি তৈরি করার পরামর্শ দিই। উদাহরণস্বরূপ, আপনি যদি জাভা ব্যবহার করেন, java.util.UUID.randomUUID().toString() ভাল কাজ করবে।

যখন আপনার অ্যাপ্লিকেশনটি দীর্ঘ সময়ের জন্য বস্তুর ট্র্যাক রাখতে চায়, তখন অবজেক্ট আইডির উপর নির্ভর করবেন না, কারণ এটি পরিবর্তন হতে পারে। আরো বিস্তারিত জানার জন্য নিম্নলিখিত বিভাগ দেখুন.

অবজেক্ট আইডি ব্যবহার না করে অবজেক্টের ট্র্যাক রাখা

আপনি যখন একটি স্লাইড API অনুরোধ করেন, তখন অবজেক্ট আইডি সাধারণত সংরক্ষিত থাকে। (যেকোন ব্যতিক্রম পদ্ধতির রেফারেন্স ডকুমেন্টেশনে বলা হয়।) ড্রাইভ এপিআইয়ের সাথে একটি সম্পূর্ণ উপস্থাপনার একটি অনুলিপি তৈরি করা অবজেক্ট আইডিও সংরক্ষণ করে।

যাইহোক, আপনি স্লাইড UI-তে উপস্থাপনা পরিবর্তন করার পরে একটি অবজেক্ট আইডি অপরিবর্তিত থাকার উপর নির্ভর করতে পারবেন না। উদাহরণস্বরূপ, যদি কেউ একটি পৃষ্ঠা উপাদান কপি-পেস্ট করতে স্লাইড UI ব্যবহার করে এবং তারপরে আসলটি মুছে ফেলে, তাহলে পৃষ্ঠার উপাদানটির এখন একটি নতুন অনন্য আইডি থাকবে এবং আপনি API এর মাধ্যমে পূর্বে যে IDটি প্রদান করেছিলেন তা হারিয়ে যাবে৷ ফলস্বরূপ, আমরা আপনাকে আপনার অ্যাপ্লিকেশনের স্টোরেজে অবজেক্ট আইডি সংরক্ষণ করার পরামর্শ দিই না। পরিবর্তে, আপনার উপস্থাপনায় এর পাঠ্য বিষয়বস্তু বা অল্ট-টেক্সট দ্বারা বস্তুগুলি খুঁজে পাওয়া উচিত।

নতুন তৈরি উপস্থাপনাগুলি সাধারণত ডিফল্ট স্লাইড, মাস্টার এবং টেক্সট বক্সের জন্য আইডিগুলির একটি ধারাবাহিক সেট ব্যবহার করে। এই আইডিগুলি সময়ের সাথে পরিবর্তিত হতে পারে, তাই আমরা আপনাকে এই বৈশিষ্ট্যটির উপর নির্ভর করার পরামর্শ দিই না। পরিবর্তে, create() অথবা get() কলের মাধ্যমে প্রেজেন্টেশন অবজেক্ট ব্যবহার করে আপনি যে উপাদানগুলি পরিবর্তন করতে চান তা খুঁজুন।