গুগল স্লাইডস এপিআই আপনাকে প্রেজেন্টেশন, পেজ এবং পেজ এলিমেন্টের ডেটা পড়তে দেয়। এই পৃষ্ঠার উদাহরণগুলিতে presentations.get এবং presentations.pages.get উভয় পদ্ধতি ব্যবহার করে কীভাবে সাধারণ রিড অপারেশনগুলি সম্পাদন করতে হয় তা দেখানো হয়েছে।
এই উদাহরণগুলিতে নিম্নলিখিত প্লেসহোল্ডারগুলি ব্যবহার করা হয়েছে:
- PRESENTATION_ID — এটি নির্দেশ করে যে আপনি প্রেজেন্টেশন আইডিটি কোথায় প্রদান করবেন। আপনি প্রেজেন্টেশন ইউআরএল (URL) থেকে এই আইডিটির মান জানতে পারবেন।
- PAGE_ID — এটি নির্দেশ করে যে আপনি কোথায় পেজ অবজেক্ট আইডি প্রদান করবেন। আপনি URL থেকে অথবা একটি API রিড রিকোয়েস্ট ব্যবহার করে এর মান পেতে পারেন।
ভাষা নিরপেক্ষতার জন্য এই উদাহরণগুলো HTTP অনুরোধ হিসেবে উপস্থাপন করা হয়েছে। উদাহরণগুলো এই উদাহরণ প্রেজেন্টেশন থেকে নেওয়া হয়েছে, যার PRESENTATION_ID হলো 1EAYk18WDjIG-zp_0vLm3CsfQh_i8eXc67Jo2O9C6Vuc । এই প্রেজেন্টেশনের প্রথম স্লাইডের PAGE_ID হলো ge63a4b4_1_0 ।
এখানের উদাহরণগুলিতে প্রেজেন্টেশন, স্লাইড এবং পেজ এলিমেন্ট সম্পর্কে শুধুমাত্র নির্দিষ্ট অনুরোধকৃত তথ্য ফেরত দেওয়ার জন্য ফিল্ড মাস্ক ব্যবহার করা হয়েছে। ফিল্ড মাস্ক ব্যবহার করলে পারফরম্যান্সও উন্নত হয়।
স্লাইড অবজেক্ট আইডিগুলো পড়ুন
নিম্নলিখিত presentations.get কোড নমুনাটি দেখায় কিভাবে প্রেজেন্টেশন থেকে সমস্ত স্লাইড অবজেক্ট আইডি-র একটি তালিকা পুনরুদ্ধার করতে হয়। আইডিগুলি স্লাইড প্রেজেন্টেশনের ক্রমানুসারে ফেরত দেওয়া হয় এবং পরবর্তী API অনুরোধগুলিতে নির্দিষ্ট স্লাইড নির্দেশ করতে ব্যবহার করা যেতে পারে। আপনি fields=masters.objectId এবং fields=layout.objectId ব্যবহার করে একইভাবে মাস্টার এবং লেআউট পেজের অবজেক্ট আইডিগুলিও পেতে পারেন।
স্লাইড অবজেক্ট আইডিগুলো পড়ার জন্য অনুরোধ প্রোটোকলটি নিম্নরূপ:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID?fields=slides.objectId
প্রতিক্রিয়াটিতে একটি Presentation অবজেক্ট থাকে, যার মধ্যে অনুরোধ করা অবজেক্ট আইডিগুলো অন্তর্ভুক্ত থাকে:
{
"slides": [
{
"objectId": "ge63a4b4_1_0"
},
{
"objectId": "ge63a4b4_1_9"
},
{
"objectId": "ge63a4b4_1_23"
},
{
"objectId": "ge63a4b4_1_35"
},
{
"objectId": "ge63a4b4_1_43"
}
]
}একটি পৃষ্ঠা থেকে এলিমেন্ট অবজেক্ট আইডিগুলো পড়ুন
নিম্নলিখিত presentations.pages.get কোড নমুনাটি দেখায় কিভাবে একটি পৃষ্ঠার সমস্ত উপাদানের অবজেক্ট আইডিগুলির একটি তালিকা পুনরুদ্ধার করতে হয়।
একটি পৃষ্ঠা থেকে এলিমেন্ট অবজেক্ট আইডিগুলো পড়ার জন্য নিম্নলিখিত অনুরোধ প্রোটোকলটি ব্যবহৃত হয়:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.objectId
প্রতিক্রিয়াটিতে একটি Page অবজেক্ট থাকে, যার মধ্যে অনুরোধ করা অবজেক্ট আইডিগুলো অন্তর্ভুক্ত থাকে:
{
"pageElements": [
{
"objectId": "ge63a4b4_1_5"
},
{
"objectId": "ge63a4b4_1_6"
},
{
"objectId": "ge63a4b4_1_7"
},
{
"objectId": "ge63a4b4_1_8"
}
]
}একটি পৃষ্ঠা থেকে আকৃতির উপাদানগুলি পড়ুন
নিম্নলিখিত presentations.pages.get কোড নমুনাটি দেখায় কিভাবে একটি পৃষ্ঠার সমস্ত Shapes এর তালিকা পুনরুদ্ধার করতে হয়। আপনি fields প্যারামিটার ব্যবহার করে অন্যান্য PageElement প্রকারগুলি নির্দিষ্ট করে পুনরুদ্ধার করতে পারেন। উদাহরণস্বরূপ, fields=pageElements(line,table) শুধুমাত্র line এবং table পেজ এলিমেন্টগুলির তথ্য ফেরত দেয়, যদি পৃষ্ঠায় এগুলি উপস্থিত থাকে।
একটি পৃষ্ঠা থেকে আকৃতির উপাদানগুলি পড়ার জন্য অনুরোধ প্রোটোকলটি নিম্নরূপ:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID?fields=pageElements.shape
রেসপন্সটিতে একটি Page অবজেক্ট থাকে, যার মধ্যে অনুরোধ করা শেপ এলিমেন্টগুলো থাকে। খালি বন্ধনীগুলো সেইসব পেজ এলিমেন্টকে নির্দেশ করে যেগুলো শেপ টাইপের নয়; এই ক্ষেত্রে, এগুলো হলো ইমেজ পেজ এলিমেন্ট।
{ "pageElements": [ {}, {}, { "shape": { "shapeProperties" { "outline" { "dashStyle": "SOLID", "outlineFill": { "solidFill": { "alpha": 1, "color": { "rgbColor": {} } }, }, "propertyState": "NOT_RENDERED", "weight": { "magnitude": 9525, "unit": "EMU" } }, "shadow": { "alignment": "BOTTOM_LEFT", "alpha": 1, "blurRadius": { "unit": "EMU" }, "color": { "rgbColor": {} }, "propertyState": "NOT_RENDERED", "rotateWithShape": false, "transform": { "scaleX": 1, "scaleY": 1, "unit": "EMU" }, "type": "OUTER" }, "shapeBackgroundFill" : { "propertyState": "NOT_RENDERED", "solidFill": { "alpha": 1, "color": { "rgbColor: { "blue": 1, "green": 1, "red": 1 } } } } }, "shapeType": "TEXT_BOX", "text": { "textElements": [ { "endIndex": 11, "paragraphMarker": { "style": { "alignment": "START", "direction": "LEFT_TO_RIGHT", "indentEnd": { "unit": "PT" }, "indentFirstLine": { "unit": "PT" }, "indentStart": { "unit": "PT" }, "lineSpacing": 100, "spaceAbove": { "unit": "PT" }, "spaceBelow": { "unit": "PT" }, "spacingMode": "COLLAPSE_LISTS" } } }, { "endIndex": 11, "textRun": { "content": "Baby Album\n", "style": { "backgroundColor": {}, "baselineOffset": "NONE", "bold": false, "fontFamily": "Arial", "fontSize": { "magnitude": 14, "unit": "PT" }, "foregroundColor": { "opaqueColor": { "rgbColor": {} } }, "italic": false, "smallCaps": false, "strikethrough": false, "underline": false } } } ] } } }, ... ] }