মৌলিক লেখা

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

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

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

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

একটি স্লাইডে একটি পাঠ্য বাক্স যুক্ত করুন৷

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

প্রথম অনুরোধটি পাঠ্য বাক্সের জন্য ব্যবহার করার জন্য অবজেক্ট আইডি নির্দিষ্ট করে । এটি দ্বিতীয় অনুরোধটিকে একই 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 কোড নমুনা দেখায় কিভাবে PAGE_ELEMENT_ID দ্বারা নির্দিষ্ট করা পৃষ্ঠা উপাদান এবং PAGE_ID দ্বারা নির্দিষ্ট করা স্লাইড দুটি পৃথক অনুরোধ ব্যবহার করে মুছে ফেলার জন্য DeleteObjectRequest পদ্ধতি ব্যবহার করতে হয়৷

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

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

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

এই অনুরোধটি শুধুমাত্র একটি নির্দিষ্ট আকারের পাঠ্যকে প্রভাবিত করে৷ একটি উপস্থাপনার মধ্যে সর্বত্র পাঠ প্রতিস্থাপন করতে, 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
      }
    }
  ]
}