মৌলিক লেখা

Google Slides API আপনাকে উপস্থাপনা পৃষ্ঠাগুলিতে উপাদান যোগ এবং পরিবর্তন করতে দেয়। এই পৃষ্ঠার উদাহরণগুলি presentations.batchUpdate পদ্ধতি ব্যবহার করে সাধারণ পঠন ক্রিয়াকলাপগুলি কীভাবে সম্পাদন করতে হয় তা দেখায়।

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

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

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

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

নিম্নলিখিত presentations.batchUpdate কোড নমুনাটি দেখায় কিভাবে CreateShapeRequest পদ্ধতি ব্যবহার করে PAGE_ID দ্বারা নির্দিষ্ট একটি স্লাইডে একটি নতুন টেক্সট বক্স ("আমার যোগ করা টেক্সট বক্স" স্ট্রিং সহ) যোগ করতে হয়। অনুরোধের বডিতে দুটি অনুরোধ নির্দিষ্ট করা হয়েছে - একটি টেক্সট বক্স আকৃতি তৈরি করার জন্য (একটি নির্দিষ্ট আকার এবং অবস্থান সহ) এবং দ্বিতীয়টি এতে টেক্সট সন্নিবেশ করার জন্য।

প্রথম অনুরোধটি টেক্সট বক্সের জন্য কোন অবজেক্ট আইডি ব্যবহার করতে হবে তা নির্দিষ্ট করে । এটি দ্বিতীয় অনুরোধটিকে একই API কলে এটি ব্যবহার করতে দেয়, যার ফলে ওভারহেড হ্রাস পায়।

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 150,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Added Text Box",
        "insertionIndex": 0
      }
    }
  ]
}

একটি স্লাইডে একটি ছবি যোগ করুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনাটি দেখায় কিভাবে PAGE_ID দ্বারা নির্দিষ্ট স্লাইডে একটি ছবি যোগ করার জন্য CreateImageRequest পদ্ধতি ব্যবহার করতে হয়। API IMAGE_URL ব্যবহার করে ছবিটি পুনরুদ্ধার করে। এই অনুরোধটি স্লাইডে ছবিটিকে স্কেল এবং অবস্থান নির্ধারণ করে।

স্লাইডে একটি ছবি যোগ করার অনুরোধ প্রোটোকলটি নিম্নরূপ:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 30,
              "unit": "PT"
            },
            "height": {
              "magnitude": 30,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

একটি পৃষ্ঠা বা পৃষ্ঠার উপাদান মুছুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনাটি দেখায় কিভাবে DeleteObjectRequest পদ্ধতি ব্যবহার করে PAGE_ELEMENT_ID দ্বারা নির্দিষ্ট পৃষ্ঠা উপাদান এবং PAGE_ID দ্বারা নির্দিষ্ট স্লাইড দুটি পৃথক অনুরোধ ব্যবহার করে মুছে ফেলা যায়।

একটি পৃষ্ঠা বা পৃষ্ঠার উপাদান মুছে ফেলার অনুরোধ প্রোটোকলটি নিম্নরূপ:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

নির্দিষ্ট আকারে টেক্সট সম্পাদনা করুন

নিম্নলিখিত presentations.batchUpdate কোড নমুনাটি দেখায় কিভাবে DeleteTextRequest পদ্ধতি ব্যবহার করে PAGE_ELEMENT_ID দ্বারা নির্দিষ্ট আকারে উপস্থিত টেক্সটের একটি অংশ প্রতিস্থাপন করতে হয়। এটি সম্পন্ন করার জন্য, প্রথমে শূন্য-ভিত্তিক startIndex ব্যবহার করে টেক্সট মুছে ফেলুন এবং তারপর সেই অবস্থানে নতুন টেক্সট সন্নিবেশ করান। এই উদাহরণে, মূল টেক্সট স্ট্রিং "My Shape Text: ????" "My Shape Text: Trapezoid" দিয়ে প্রতিস্থাপিত হয়েছে।

এই অনুরোধটি শুধুমাত্র একটি নির্দিষ্ট আকারের টেক্সটকে প্রভাবিত করে। একটি উপস্থাপনার মধ্যে সর্বত্র টেক্সট প্রতিস্থাপন করতে, ReplaceAllTextRequest পদ্ধতি ব্যবহার করুন।

নির্দিষ্ট আকারে টেক্সট সম্পাদনা করার জন্য অনুরোধ প্রোটোকলটি নিম্নরূপ:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "deleteText": {
        "objectId": PAGE_ELEMENT_ID,
        "textRange": {
          "type": "FROM_START_INDEX",
          "startIndex": 15
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "Trapezoid",
        "insertionIndex": 15
      }
    }
  ]
}

একটি আকৃতি ট্যাগকে একটি চিত্র দিয়ে প্রতিস্থাপন করুন

ট্যাগ হলো টেক্সট বক্স বা আকার যার একটি অনন্য স্ট্রিং নাম থাকে, যেমন "অ্যাকাউন্ট-হোল্ডার-নাম"।

নিম্নলিখিত presentations.batchUpdate কোড নমুনাটি দেখায় যে কীভাবে CreateImageRequest পদ্ধতি ব্যবহার করে একটি আকৃতি ট্যাগের একক উদাহরণকে একটি চিত্র দিয়ে প্রতিস্থাপন করতে হয়, একই অবস্থান বজায় রাখা হয় এবং ছবির আকৃতির অনুপাত বজায় রেখে ট্যাগের আকারের সাথে মানানসই স্কেল করা যায়।

এই অনুরোধটি একটি ছবি অন্যটি দিয়ে প্রতিস্থাপন করতেও ব্যবহার করা যেতে পারে। অনুরোধটিতে নতুন ছবি যোগ করা এবং তারপর ট্যাগটি মুছে ফেলা অন্তর্ভুক্ত।

CreateImageRequest পদ্ধতিটি শুধুমাত্র একটি নির্দিষ্ট আকৃতি প্রতিস্থাপন করে। একটি উপস্থাপনার মধ্যে সর্বত্র ট্যাগ আকার প্রতিস্থাপন করতে, একটি ReplaceAllShapesWithImageRequest পদ্ধতি ব্যবহার করুন।

শেপ ট্যাগে নিম্নলিখিত PageElement বৈশিষ্ট্য রয়েছে (যা presentations.pages.get অনুরোধ ব্যবহার করে পাওয়া যাবে):

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 1.13,
    "scaleY": 0.62,
    "translateX": 4800000,
    "translateY":  450000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RECTANGLE"
  }
}

আকৃতিটি PAGE_ID দ্বারা নির্দিষ্ট স্লাইডে থাকে। আকৃতিটি প্রতিস্থাপনকারী চিত্রটি নির্দিষ্ট করতে, API IMAGE_URL ব্যবহার করে চিত্রটি পুনরুদ্ধার করে। ট্যাগের আকারের মধ্যে সীমাবদ্ধ রেখে চিত্রের আকৃতির অনুপাত সংরক্ষণ করতে, CreateImageRequest পদ্ধতিটি চিত্রের আকারকে ট্যাগের আকার এবং স্কেলের গুণফলের সাথে এবং চিত্রের স্কেল ফ্যাক্টরগুলিকে 1 এ সেট করে। আরও তথ্যের জন্য, প্রিজারভ অ্যাসপেক্ট রেশিও দেখুন।

একটি আকৃতি ট্যাগকে একটি চিত্র দিয়ে প্রতিস্থাপন করার অনুরোধ প্রোটোকলটি নিম্নরূপ:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000 * 1.13,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000 * 0.62,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4800000,
            "translateY": 450000,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      }
    }
  ]
}