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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির সাহায্যে, আপনি এডিটরগুলির মধ্যে কাস্টমাইজড ইন্টারফেস প্রদান করতে পারেন, যার মধ্যে রয়েছে গুগল ডক্স, শিট এবং স্লাইড। এটি আপনাকে ব্যবহারকারীকে প্রাসঙ্গিক তথ্য প্রদান করতে, কাজগুলি স্বয়ংক্রিয় করতে এবং তৃতীয় পক্ষের সিস্টেমগুলিকে এডিটরদের সাথে সংযুক্ত করতে দেয়।

অ্যাড-অন UI অ্যাক্সেস করা

ডক্স, শিট এবং স্লাইডস ইউজার ইন্টারফেসের ডানদিকে গুগল ওয়ার্কস্পেস কুইক অ্যাক্সেস সাইড প্যানেলে যদি এর আইকনটি দেখা যায়, তাহলে আপনি এডিটরগুলিতে একটি গুগল ওয়ার্কস্পেস অ্যাড-অন খুলতে পারেন।

একটি Google Workspace অ্যাড-অন নিম্নলিখিত ইন্টারফেসগুলি উপস্থাপন করতে পারে:

• হোমপেজ ইন্টারফেস : যদি অ্যাড-অনের ম্যানিফেস্টে এডিটরের জন্য EDITOR_NAME .homepageTrigger ট্রিগার থাকে, তাহলে ব্যবহারকারী অ্যাড-অনটি খোলে, অ্যাড-অনটি সেই এডিটরের জন্য বিশেষভাবে একটি হোমপেজ কার্ড তৈরি করে এবং ফেরত দেয়। যদি অ্যাড-অনের ম্যানিফেস্টে এডিটরের জন্য EDITOR_NAME .homepageTrigger না থাকে, তাহলে ব্যবহারকারী এটি খোলে, একটি জেনেরিক হোমপেজ কার্ড প্রদর্শিত হয়।

• REST API ইন্টারফেস : যদি অ্যাড-অনটি REST API ব্যবহার করে, তাহলে আপনি drive.file স্কোপ ব্যবহার করে প্রতিটি ফাইলের জন্য একটি ডকুমেন্ট অ্যাক্সেসের অনুরোধকারী ট্রিগারগুলি অন্তর্ভুক্ত করতে পারেন। একবার অনুমোদিত হলে, EDITOR_NAME .onFileScopeGrantedTrigger নামক আরেকটি ট্রিগার ফাইলের জন্য নির্দিষ্ট একটি ইন্টারফেস কার্যকর করে এবং প্রদর্শন করে।

• লিঙ্ক প্রিভিউ ইন্টারফেস : যদি আপনার অ্যাড-অনটি কোনও তৃতীয় পক্ষের পরিষেবার সাথে সংহত হয়, তাহলে আপনি এমন কার্ড তৈরি করতে পারেন যা আপনার পরিষেবার URL থেকে সামগ্রীর পূর্বরূপ দেখে।

এডিটর অ্যাড-অনের জন্য ইন্টারফেস তৈরি করা

এই ধাপগুলি অনুসরণ করে সম্পাদকদের জন্য সম্পাদক অ্যাড-অন ইন্টারফেস তৈরি করুন:

1. অ্যাড-অন স্ক্রিপ্ট প্রজেক্ট ম্যানিফেস্টে উপযুক্ত addOns.common , addOns.docs , addOns.sheets এবং addOns.slides ক্ষেত্রগুলি যোগ করুন।
2. আপনার স্ক্রিপ্ট প্রজেক্ট ম্যানিফেস্টে যেকোনো প্রয়োজনীয় এডিটর স্কোপ যোগ করুন।
3. যদি আপনি একটি সম্পাদক-নির্দিষ্ট হোমপেজ প্রদান করেন, তাহলে ইন্টারফেস তৈরি করতে EDITOR_NAME .homepageTrigger ফাংশনটি প্রয়োগ করুন। যদি না হয়, তাহলে আপনার হোস্ট অ্যাপগুলির জন্য একটি সাধারণ হোমপেজ তৈরি করতে common.homepageTrigger ইন্টারফেসটি ব্যবহার করুন।
4. যদি আপনি REST API ব্যবহার করেন, তাহলে drive.file স্কোপ অথোরাইজেশন ফ্লো এবং EDITOR_NAME .onFileScopeGrantedTrigger ট্রিগার ফাংশনটি প্রয়োগ করুন যাতে খোলা ফাইলের জন্য নির্দিষ্ট একটি ইন্টারফেস প্রদর্শিত হয়। আরও তথ্যের জন্য, REST API ইন্টারফেস দেখুন।
5. যদি আপনি কোনও তৃতীয় পক্ষের পরিষেবা থেকে লিঙ্ক প্রিভিউ কনফিগার করেন, তাহলে https://www.googleapis.com/auth/workspace.linkpreview স্কোপ অথোরাইজেশন ফ্লো এবং linkPreviewTriggers ফাংশনটি প্রয়োগ করুন। আরও তথ্যের জন্য, লিঙ্ক প্রিভিউ ইন্টারফেস দেখুন।
6. ব্যবহারকারীর UI ইন্টারঅ্যাকশন, যেমন বোতাম ক্লিকের প্রতিক্রিয়া জানাতে প্রয়োজনীয় সংশ্লিষ্ট কলব্যাক ফাংশনগুলি বাস্তবায়ন করুন।

সম্পাদকের হোমপেজ

আপনার অ্যাড-অনের স্ক্রিপ্ট প্রজেক্টে অবশ্যই একটি হোমপেজ ট্রিগার ফাংশন প্রদান করতে হবে যা একটি একক Card বা অ্যাড-অনের হোমপেজ তৈরি করে এমন Card অবজেক্টের একটি অ্যারে তৈরি করে এবং ফেরত দেয়।

হোমপেজ ট্রিগার ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি প্যারামিটার হিসেবে পাস করে যাতে ক্লায়েন্টের প্ল্যাটফর্মের মতো তথ্য থাকে। আপনি হোমপেজের নির্মাণের জন্য ইভেন্ট অবজেক্ট ডেটা ব্যবহার করতে পারেন।

আপনি একটি সাধারণ হোমপেজ অথবা এমন একটি হোমপেজ উপস্থাপন করতে পারেন যা ব্যবহারকারী আপনার অ্যাড-অনটি যে সম্পাদকে খোলেন তার সাথে সম্পর্কিত।

সাধারণ হোমপেজটি প্রদর্শন করুন

এডিটরগুলিতে আপনার অ্যাড-অনের সাধারণ হোমপেজটি দেখানোর জন্য, অ্যাড-অনের ম্যানিফেস্টে উপযুক্ত এডিটর ক্ষেত্রগুলি, যেমন addOns.docs , addOns.sheets , অথবা addOns.slides অন্তর্ভুক্ত করুন।

নিচের উদাহরণটি Google Workspace অ্যাড-অন ম্যানিফেস্টের addons অংশ দেখায়। অ্যাড-অনটি Docs, Sheets এবং Slides প্রসারিত করে এবং প্রতিটি হোস্ট অ্যাপে সাধারণ হোমপেজ দেখায়।

 "addOns": {
    "common": {
      "name": "Translate",
      "logoUrl": "https://www.gstatic.com/images/branding/product/1x/translate_24dp.png",
      "layoutProperties": {
        "primaryColor": "#2772ed"
      },
      "homepageTrigger": {
        "runFunction": "onHomepage"
      }
    },
    "docs": {},
    "sheets": {},
    "slides": {}
  }
}

একটি সম্পাদক-নির্দিষ্ট হোমপেজ প্রদর্শন করুন

একটি সম্পাদকের জন্য নির্দিষ্ট একটি হোমপেজ উপস্থাপন করতে, অ্যাড-অন ম্যানিফেস্টে EDITOR_NAME .homepageTrigger যোগ করুন।

নিচের উদাহরণে Google Workspace অ্যাড-অন ম্যানিফেস্টের addons অংশ দেখানো হয়েছে। অ্যাড-অনটি Docs, Sheets এবং Slides-এর জন্য সক্রিয় করা হয়েছে। এটি Docs এবং Slides-এ সাধারণ হোমপেজ এবং Sheets-এ একটি অনন্য হোমপেজ প্রদর্শন করে। onSheetsHomepage কলব্যাক ফাংশনটি Sheets-নির্দিষ্ট হোমপেজ কার্ড তৈরি করে।

 "addOns": {
    "common": {
      "name": "Translate",
      "logoUrl": "https://www.gstatic.com/images/branding/product/1x/translate_24dp.png",
      "layoutProperties": {
        "primaryColor": "#2772ed"
      },
      "homepageTrigger": {
        "runFunction": "onHomepage"
      }
    },
    "docs": {},
    "slides": {},
    "sheets": {
     "homepageTrigger": {
       "runFunction": "onSheetsHomepage"
     },
  }
}

REST API ইন্টারফেস

যদি আপনার অ্যাড-অন REST API ব্যবহার করে, যেমন Google Sheets API , তাহলে আপনি onFileScopeGrantedTrigger ফাংশন ব্যবহার করে Editor host অ্যাপে খোলা ফাইলের জন্য নির্দিষ্ট একটি নতুন ইন্টারফেস প্রদর্শন করতে পারেন।

onFileScopeGrantedTrigger ফাংশন ব্যবহার করার জন্য আপনাকে drive.file স্কোপ অনুমোদন প্রবাহ অন্তর্ভুক্ত করতে হবে। drive.file স্কোপ কীভাবে অনুরোধ করবেন তা জানতে, বর্তমান নথির জন্য ফাইল অ্যাক্সেসের অনুরোধ দেখুন।

যখন একজন ব্যবহারকারী drive.file স্কোপ প্রদান করে, তখন EDITOR_NAME .onFileScopeGrantedTrigger.runFunction সক্রিয় হয়। যখন ট্রিগার সক্রিয় হয়, তখন এটি অ্যাড-অন ম্যানিফেস্টে EDITOR_NAME .onFileScopeGrantedTrigger.runFunction ক্ষেত্রের দ্বারা নির্দিষ্ট প্রাসঙ্গিক ট্রিগার ফাংশনটি কার্যকর করে।

যেকোনো একটি এডিটরের জন্য REST API ইন্টারফেস তৈরি করতে, নীচের ধাপগুলি অনুসরণ করুন। EDITOR_NAME পরিবর্তে আপনার পছন্দের এডিটর হোস্ট অ্যাপটি ব্যবহার করুন, উদাহরণস্বরূপ, sheets.onFileScopeGrantedTrigger ।

1. আপনার ম্যানিফেস্টের উপযুক্ত সম্পাদক বিভাগে EDITOR_NAME .onFileScopeGrantedTrigger অন্তর্ভুক্ত করুন। উদাহরণস্বরূপ, যদি আপনি Google Sheets-এ এই ইন্টারফেসটি তৈরি করতে চান, তাহলে "sheets" বিভাগে ট্রিগারটি যোগ করুন।
2. EDITOR_NAME .onFileScopeGrantedTrigger বিভাগে নামক ফাংশনটি বাস্তবায়ন করুন। এই ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি আর্গুমেন্ট হিসেবে গ্রহণ করে এবং অবশ্যই একটি একক Card অবজেক্ট অথবা Card অবজেক্টের একটি অ্যারে প্রদান করবে।
3. যেকোনো কার্ডের মতো, ইন্টারফেসের জন্য উইজেট ইন্টারঅ্যাক্টিভিটি প্রদানের জন্য ব্যবহৃত কলব্যাক ফাংশনগুলি আপনাকে অবশ্যই বাস্তবায়ন করতে হবে। উদাহরণস্বরূপ, যদি আপনি ইন্টারফেসে একটি বোতাম অন্তর্ভুক্ত করেন, তাহলে এতে একটি সংযুক্ত অ্যাকশন এবং একটি বাস্তবায়িত কলব্যাক ফাংশন থাকা উচিত যা বোতামটি ক্লিক করার সময় চলে।

নিচের উদাহরণটি একটি Google Workspace অ্যাড-অন ম্যানিফেস্টের addons অংশ দেখায়। অ্যাড-অনটি REST API ব্যবহার করে, তাই onFileScopeGrantedTrigger Google Sheets-এর জন্য অন্তর্ভুক্ত করা হয়। যখন একজন ব্যবহারকারী drive.file স্কোপ প্রদান করেন, তখন কলব্যাক ফাংশন onFileScopeGrantedSheets একটি ফাইল-নির্দিষ্ট ইন্টারফেস তৈরি করে।

"addOns": {
   "common": {
     "name": "Productivity add-on",
     "logoUrl": "https://www.gstatic.com/images/icons/material/system_gm/1x/work_outline_black_18dp.png",
     "layoutProperties": {
       "primaryColor": "#669df6",
       "secondaryColor": "#ee675c"
     }
   },
   "sheets": {
     "homepageTrigger": {
       "runFunction": "onEditorsHomepage"
     },
     "onFileScopeGrantedTrigger": {
       "runFunction": "onFileScopeGrantedSheets"
     }
   }

তৃতীয় পক্ষের পরিষেবাগুলির জন্য লিঙ্ক প্রিভিউ ইন্টারফেস

তৃতীয় পক্ষের পরিষেবার জন্য লিঙ্ক প্রিভিউ চালু করতে, আপনাকে আপনার অ্যাড-অনের ম্যানিফেস্টে লিঙ্ক প্রিভিউ কনফিগার করতে হবে এবং একটি ফাংশন তৈরি করতে হবে যা একটি প্রিভিউ কার্ড ফেরত দেয়। যেসব পরিষেবার জন্য ব্যবহারকারীর অনুমোদন প্রয়োজন, তাদের জন্য আপনার ফাংশনকে অনুমোদন প্রবাহও চালু করতে হবে।

লিঙ্ক প্রিভিউ চালু করার ধাপগুলির জন্য, স্মার্ট চিপ সহ লিঙ্কগুলির প্রিভিউ দেখুন।

ইভেন্ট অবজেক্ট

একটি ইভেন্ট অবজেক্ট তৈরি করা হয় এবং ট্রিগার ফাংশনগুলিতে প্রেরণ করা হয়, যেমন EDITOR_NAME .homepageTrigger অথবা EDITOR_NAME .onFileScopeGrantedTrigger । ট্রিগার ফাংশন ইভেন্ট অবজেক্টের তথ্য ব্যবহার করে অ্যাড-অন কার্ড কীভাবে তৈরি করতে হয় বা অন্যথায় অ্যাড-অন আচরণ নিয়ন্ত্রণ করতে হয় তা নির্ধারণ করে।

ইভেন্ট অবজেক্টের সম্পূর্ণ কাঠামো Event objects এ বর্ণনা করা হয়েছে।

যখন কোনও এডিটর অ্যাড-অনের ভারপ্রাপ্ত হোস্ট অ্যাপ হয়, তখন ইভেন্ট অবজেক্টের মধ্যে ডক্স , শিটস , অথবা স্লাইডস ইভেন্ট অবজেক্ট ফিল্ড অন্তর্ভুক্ত থাকে যা ক্লায়েন্টের তথ্য বহন করে।

যদি অ্যাড-অনটিতে বর্তমান ব্যবহারকারী বা ডকুমেন্টের জন্য drive.file স্কোপ অনুমোদন না থাকে, তাহলে ইভেন্ট অবজেক্টে শুধুমাত্র docs.addonHasFileScopePermission , sheets.addonHasFileScopePermission , অথবা slides.addonHasFileScopePermission ক্ষেত্র থাকে। যদি অ্যাড-অনের অনুমোদন থাকে, তাহলে ইভেন্ট অবজেক্টে সমস্ত Editor ইভেন্ট অবজেক্ট ক্ষেত্র থাকে।

নিচের উদাহরণে একটি Editor ইভেন্ট অবজেক্ট দেখানো হয়েছে যা sheets.onFileScopeGrantedTrigger ফাংশনে পাস করা হয়েছে। এখানে, অ্যাড-অনটিতে বর্তমান ডকুমেন্টের জন্য drive.file স্কোপ অনুমোদন রয়েছে:

`        {
          "commonEventObject": { ... },
          "sheets": {
            "addonHasFileScopePermission": true,
            "id":"A_24Q3CDA23112312ED52",
            "title":"How to get started with Sheets"
          },
          ...
        }