স্লাইড অপারেশন

Google Slides API আপনাকে স্লাইডগুলি তৈরি করতে, সরাতে এবং মুছতে দেয়৷ এই পৃষ্ঠার উদাহরণগুলি presentations.batchUpdate পদ্ধতি ব্যবহার করে কিছু সাধারণ স্লাইড অপারেশন দেখায়।

এই উদাহরণগুলি নিম্নলিখিত ভেরিয়েবল ব্যবহার করে:

  • PRESENTATION_ID — আপনি কোথায় উপস্থাপনা ID প্রদান করেন তা নির্দেশ করে। আপনি উপস্থাপনা URL থেকে এই আইডির মান আবিষ্কার করতে পারেন৷
  • PAGE_ID এবং PAGE_ID2 — আপনি কোথায় পৃষ্ঠা অবজেক্ট আইডি প্রদান করেন তা নির্দেশ করে। আপনি URL থেকে বা একটি API পড়ার অনুরোধ ব্যবহার করে এর জন্য মান পুনরুদ্ধার করতে পারেন।

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

একটি স্লাইড কপি করুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনা দেখায় যে কীভাবে একটি স্লাইডের অনুলিপি করতে এবং উপস্থাপনায় আসলটির পরে এটি সন্নিবেশ করতে DuplicateObjectRequest পদ্ধতি ব্যবহার করতে হয়। মূল স্লাইডটি PAGE_ID দ্বারা নির্দিষ্ট করা হয়েছে।

অনুরোধটি আপনাকে নির্দিষ্ট করতে দেয় যে কিছু বা সমস্ত পৃষ্ঠা উপাদান আইডি অনুলিপিতে থাকা উচিত ( কিছু বিধিনিষেধ সহ)। এই উদাহরণে, আসল স্লাইডে একটি টেবিল উপাদান রয়েছে ( TABLE_ELEMENT_ID দ্বারা নির্দিষ্ট করা হয়েছে), যেটি স্লাইড কপিতে ( COPY_TABLE_ELEMENT_ID দ্বারা নির্দিষ্ট) একটি নতুন টেবিলে ( COPY_PAGE_ID দ্বারা নির্দিষ্ট) ম্যাপ করা হয়েছে। অনুলিপিতে অন্যান্য সমস্ত উপাদান র্যান্ডম আইডি দেওয়া হয়।

টেক্সট বক্স, ছবি, টেবিল, মৌলিক আকার, লাইন এবং এমবেড করা ভিডিও সহ একটি PageElement অনুলিপি করার বিষয়ে আরও তথ্যের জন্য, নমুনা দেখুন একটি উপাদান অনুলিপি করুন এবং সম্পাদনা করুন

একটি স্লাইড অনুলিপি করার অনুরোধ প্রোটোকল নিম্নলিখিত:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

একটি স্লাইড তৈরি করুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনা দেখায় কিভাবে একটি স্লাইড তৈরি করতে CreateSlideRequest পদ্ধতি ব্যবহার করতে হয় এবং উপস্থাপনায় চতুর্থ স্লাইড (শূন্য-ভিত্তিক insertionIndex ব্যবহার করে) হিসাবে এটি সন্নিবেশ করা হয়।

নতুন স্লাইডটি TITLE_AND_TWO_COLUMNS এর PredefinedLayout ব্যবহার করার জন্য সেট করা হয়েছে। আপনি স্লাইডের জন্য PAGE_ID হিসাবে ব্যবহার করার জন্য একটি স্ট্রিং নির্দিষ্ট করতে পারেন ( কিছু বিধিনিষেধ সহ), অথবা অনুরোধে ক্ষেত্রটি বাদ দিয়ে API-কে PAGE_ID তৈরি করার অনুমতি দিন।

নিম্নলিখিত একটি স্লাইড তৈরি করার জন্য অনুরোধ প্রোটোকল:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

একটি স্লাইড তৈরি করুন এবং স্থানধারক সংশোধন করুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনা দেখায় কিভাবে TITLE_AND_TWO_COLUMNS এর PredefinedLayout ব্যবহার করে একটি স্লাইড তৈরি করতে CreateSlideRequest পদ্ধতি ব্যবহার করতে হয়।

আপনি স্লাইডের জন্য PAGE_ID হিসাবে ব্যবহার করার জন্য একটি স্ট্রিং নির্দিষ্ট করতে পারেন ( কিছু সীমাবদ্ধতা সহ)। placeholderIdMappings TITLE Type ব্যবহার করে। TITLE_ID স্লাইডের স্থানধারক আকৃতির উল্লেখ করে যাতে এটি পরিবর্তন করা যায়।

একটি স্লাইড তৈরি এবং স্থানধারক সংশোধন করার অনুরোধ প্রোটোকলটি নিম্নরূপ:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

একটি নতুন অবস্থানে স্লাইড সরান

নিম্নলিখিত presentations.batchUpdate কোড নমুনা দেখায় কিভাবে UpdateSlidesPositionRequest পদ্ধতি ব্যবহার করে দুটি নির্দিষ্ট স্লাইড নিতে হয় এবং তাদের আপেক্ষিক ক্রম বজায় রেখে উপস্থাপনার শুরুতে নিয়ে যেতে হয়।

নির্দিষ্ট স্লাইড আইডি ( PAGE_ID এবং PAGE_ID2 ) অবশ্যই বিদ্যমান উপস্থাপনা ক্রমানুসারে প্রদান করতে হবে, সদৃশ ছাড়াই। শূন্য-ভিত্তিক insertionIndex নির্দেশ করে যেখানে স্লাইডগুলি সন্নিবেশ করা উচিত, স্থানান্তর হওয়ার আগে অর্ডারের উপর ভিত্তি করে। মানটি অবশ্যই শূন্য এবং উপস্থাপনায় স্লাইডের সংখ্যার মধ্যে হতে হবে, অন্তর্ভুক্ত।

স্লাইডগুলিকে একটি নতুন অবস্থানে সরানোর জন্য নিম্নলিখিত অনুরোধ প্রোটোকল:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

একটি স্লাইড ব্যাকগ্রাউন্ড ইমেজ সেট করুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনা দেখায় কিভাবে PAGE_ID দ্বারা নির্দিষ্ট একটি স্লাইডের পটভূমি চিত্র সেট করতে UpdatePagePropertiesRequest পদ্ধতি ব্যবহার করতে হয়। API IMAGE_URL ব্যবহার করে ছবিটি পুনরুদ্ধার করে।

একটি ফিল্ড মাস্ক ব্যবহার করা হয় নির্দিষ্ট করার জন্য যে শুধুমাত্র স্লাইড ব্যাকগ্রাউন্ড পরিবর্তন করতে হবে অন্যান্য বৈশিষ্ট্য সংরক্ষণ করতে। ফিল্ড মাস্ক ব্যবহার করলে কর্মক্ষমতাও উন্নত হয়।

বিকল্পভাবে, একটি UpdatePagePropertiesRequest পদ্ধতি একটি স্লাইডের পটভূমিকে একটি কঠিন রঙে সেট করতে ব্যবহার করা যেতে পারে।

একটি স্লাইড ব্যাকগ্রাউন্ড ইমেজ সেট করার জন্য নিম্নলিখিত অনুরোধ প্রোটোকল:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

থাম্বনেইল তৈরি করুন

আপনি presentations.pages.getThumbnail পদ্ধতিতে কল করে উপস্থাপনায় একটি নির্দিষ্ট পৃষ্ঠার সর্বশেষ সংস্করণের একটি থাম্বনেইল তৈরি করতে পারেন, যা একটি বিষয়বস্তু URL হিসাবে পৃষ্ঠার একটি থাম্বনেইল চিত্র প্রদান করে৷ ছবির URL এর একটি ডিফল্ট লাইফটাইম 30 মিনিট রয়েছে৷

আপনি একটি ক্যোয়ারী প্যারামিটার হিসাবে ThumbnailProperties ক্ষেত্র ব্যবহার করে ফিরে আসা mimeType এবং thumbnailSize উল্লেখ করতে পারেন।

নিম্নলিখিতটি ThumbnailProperties সেটের সাথে পৃষ্ঠার থাম্বনেইল তৈরি করার অনুরোধ প্রোটোকল:

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}