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

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

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

• PRESENTATION_ID — এটি নির্দেশ করে যে আপনি প্রেজেন্টেশন আইডিটি কোথায় প্রদান করবেন। আপনি প্রেজেন্টেশন ইউআরএল (URL) থেকে এই আইডিটির মান জানতে পারবেন।
• PAGE_ID এবং PAGE_ID2 — এটি নির্দেশ করে যে আপনি কোথায় পেজ অবজেক্ট আইডিগুলো প্রদান করবেন। আপনি URL থেকে অথবা একটি API রিড রিকোয়েস্ট ব্যবহার করে এর মান পেতে পারেন।

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

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

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

এই অনুরোধটি আপনাকে নির্দিষ্ট করতে দেয় যে পৃষ্ঠার কিছু বা সমস্ত এলিমেন্ট আইডি কপিতে থাকবে কি না ( কিছু সীমাবদ্ধতা সহ)। এই উদাহরণে, মূল স্লাইডে একটি টেবিল এলিমেন্ট ( TABLE_ELEMENT_ID দ্বারা নির্দিষ্ট) রয়েছে, যা স্লাইড কপিতে ( COPY_PAGE_ID দ্বারা নির্দিষ্ট) একটি নতুন টেবিলের ( COPY_TABLE_ELEMENT_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 মেথডটি কল করতে পারেন, যা পৃষ্ঠাটির একটি থাম্বনেইল ছবিকে কন্টেন্ট ইউআরএল হিসেবে রিটার্ন করে। এই ইমেজ ইউআরএলটির ডিফল্ট মেয়াদ ৩০ মিনিট।

এছাড়াও আপনি 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"
}