একটি Google Workspace অ্যাড-অন কুইকস্টার্ট তৈরি করুন

Node.js রানটাইম ব্যবহার করে ক্লাউড ফাংশনে একটি Google Workspace অ্যাড-অন তৈরি করুন।

দ্রষ্টব্য: এই কুইকস্টার্ট শুধুমাত্র উদাহরণের উদ্দেশ্যে করা হয়েছে। অ্যাপস স্ক্রিপ্টের বাইরে একটি বৈশিষ্ট্য সমৃদ্ধ অ্যাড-অন তৈরি করতে, আমরা আপনাকে ক্লাউড ফাংশনের পরিবর্তে ক্লাউড রান ব্যবহার করার পরামর্শ দিই।

উদ্দেশ্য

• আপনার পরিবেশ সেট আপ করুন।
• একটি ক্লাউড ফাংশন তৈরি করুন এবং স্থাপন করুন।
• অ্যাড-অন তৈরি করুন এবং স্থাপন করুন।
• অ্যাড-অন ইনস্টল করুন।

পূর্বশর্ত

• একটি Google ক্লাউড প্রকল্প ।
• নিশ্চিত করুন যে আপনি আপনার ক্লাউড প্রকল্পের জন্য বিলিং চালু করেছেন। আপনার প্রকল্পগুলির বিলিং স্থিতি কীভাবে যাচাই করবেন তা শিখুন।
• ক্লাউড প্রকল্পের সাথে কনফিগার করা ক্লাউড SDK ।

আপনার পরিবেশ সেট আপ করুন

Google ক্লাউড কনসোলে আপনার ক্লাউড প্রকল্প খুলুন

1. Google ক্লাউড কনসোলে, একটি প্রকল্প নির্বাচন করুন পৃষ্ঠাতে যান।

   একটি ক্লাউড প্রকল্প নির্বাচন করুন

2. আপনি যে Google ক্লাউড প্রকল্পটি ব্যবহার করতে চান সেটি নির্বাচন করুন। অথবা, প্রকল্প তৈরি করুন ক্লিক করুন এবং অন-স্ক্রীন নির্দেশাবলী অনুসরণ করুন। আপনি যদি একটি Google ক্লাউড প্রকল্প তৈরি করেন, তাহলে আপনাকে প্রকল্পটির জন্য বিলিং চালু করতে হতে পারে।

OAuth সম্মতি স্ক্রীন কনফিগার করুন

Google Workspace অ্যাড-অনগুলির জন্য একটি সম্মতি স্ক্রিন কনফিগারেশন প্রয়োজন। আপনার অ্যাড-অনের OAuth সম্মতি স্ক্রীন কনফিগার করলে তা নির্ধারণ করে যে Google ব্যবহারকারীদের কাছে কী প্রদর্শন করে।

1. Google ক্লাউড কনসোলে, মেনু > API এবং পরিষেবা > OAuth সম্মতি স্ক্রীনে যান।

   OAuth সম্মতি স্ক্রিনে যান

2. ব্যবহারকারীর প্রকারের জন্য অভ্যন্তরীণ নির্বাচন করুন, তারপরে তৈরি করুন ক্লিক করুন।
3. অ্যাপ রেজিস্ট্রেশন ফর্মটি পূরণ করুন, তারপর সংরক্ষণ করুন এবং চালিয়ে যান-এ ক্লিক করুন।

4. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন এবং সেভ এবং কন্টিনিউ এ ক্লিক করতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace সংস্থার বাইরে ব্যবহারের জন্য একটি অ্যাপ তৈরি করবেন, তখন আপনাকে অবশ্যই ব্যবহারকারীর ধরন পরিবর্তন করে External তে পরিবর্তন করতে হবে এবং তারপরে, আপনার অ্যাপের প্রয়োজনীয় অনুমোদনের সুযোগ যোগ করতে হবে।

5. আপনার অ্যাপ নিবন্ধন সারাংশ পর্যালোচনা করুন. পরিবর্তন করতে, সম্পাদনা ক্লিক করুন। অ্যাপ নিবন্ধন ঠিক আছে বলে মনে হলে, ড্যাশবোর্ডে ফিরে যান ক্লিক করুন।

একটি ক্লাউড ফাংশন তৈরি করুন এবং স্থাপন করুন

1. স্থানীয় টার্মিনালে, ক্লাউড ফাংশন, ক্লাউড বিল্ড এবং Google Workspace অ্যাড-অন API চালু করুন:

   gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
   

2. একটি খালি ডিরেক্টরিতে, নিম্নলিখিত নমুনা কোড দিয়ে function.js ফাইল তৈরি করুন:

   /**
    * Cloud Function that loads the homepage for a
    * Google Workspace Add-on.
    *
    * @param {Object} req Request sent from Google
    * @param {Object} res Response to send back
    */
   exports.loadHomePage = function addonsHomePage (req, res) {
     res.send(createAction());
   };
   
   /** Creates a card with two widgets. */
   function createAction() {
     return {
       "action": {
         "navigations": [
           {
             "pushCard": {
               "header": {
                 "title": "Cats!"
               },
               "sections": [
                 {
                   "widgets": [
                     {
                       "textParagraph": {
                         "text": "Your random cat:"
                       }
                     },
                     {
                       "image": {
                         "imageUrl": "https://cataas.com/cat"
                        }
                     }
                   ]
                 }
               ]
             }
           }
         ]
       }
     };
   }
   

3. ফাংশন স্থাপন করুন:

   gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
   

   অনুরোধ করা হলে, নির্দিষ্ট করুন যে আপনি ফাংশনের অননুমোদিত আহ্বানের অনুমতি দেবেন না। ফাংশনটি স্থাপন করতে কয়েক মিনিট সময় লাগতে পারে।

একটি অ্যাড-অন স্থাপনা তৈরি করুন

1. অ্যাড-অনের জন্য পরিষেবা অ্যাকাউন্ট ইমেল খুঁজুন:

   gcloud workspace-add-ons get-authorization
   

2. পরিষেবা অ্যাকাউন্টটিকে cloudfunctions.invoker ভূমিকা প্রদান করুন:

   gcloud functions add-iam-policy-binding loadHomePage \
       --role roles/cloudfunctions.invoker \
       --member serviceAccount:SERVICE_ACCOUNT_EMAIL
   

3. নিয়োজিত ফাংশনের URL পান। URL পেতে, নিম্নলিখিত কমান্ডটি চালান এবং httpsTrigger বিভাগের অধীনে url ক্ষেত্রটি সন্ধান করুন:

   gcloud functions describe loadHomePage
   

4. নিচের নমুনা কোড দিয়ে deployment.json ফাইলটি তৈরি করুন। আগের ধাপ থেকে স্থাপিত ফাংশনের URL দিয়ে URL প্রতিস্থাপন করুন।

   {
     "oauthScopes": ["https://www.googleapis.com/auth/gmail.addons.execute"],
     "addOns": {
       "common": {
         "name": "My HTTP Add-on",
         "logoUrl": "https://raw.githubusercontent.com/webdog/octicons-png/main/black/beaker.png",
         "homepageTrigger": {
           "runFunction": "URL"
         }
       },
       "gmail": {},
       "drive": {},
       "calendar": {},
       "docs": {},
       "sheets": {},
       "slides": {}
     }
   }
   

5. স্থাপনা তৈরি করুন:

   gcloud workspace-add-ons deployments create quickstart \
       --deployment-file=deployment.json
   

অ্যাড-অন ইনস্টল করুন

1. ডেভেলপমেন্ট মোডে স্থাপনা ইনস্টল করুন:

   gcloud workspace-add-ons deployments install quickstart
   

2. অ্যাড-অন দেখতে Gmail খুলুন বা পুনরায় লোড করুন। ডানদিকে টুলবারে, একটি বীকার আইকন খুঁজুন।

3. অ্যাড-অন খুলতে আইকনে ক্লিক করুন। অনুরোধ করা হলে, অ্যাড-অন অনুমোদন করুন।

ঐচ্ছিক: পরিষ্কার করুন

আপনার অ্যাকাউন্টে চার্জ এড়াতে, আপনার তৈরি করা সংস্থানগুলি মুছুন:

1. আপনার Google অ্যাকাউন্ট থেকে অ্যাড-অন আনইনস্টল করুন:

   gcloud workspace-add-ons deployments uninstall quickstart
   

2. এই কুইকস্টার্টে ব্যবহৃত সংস্থানগুলির জন্য চার্জ এড়াতে, ক্লাউড প্রকল্পটি মুছুন:

   gcloud projects delete PROJECT_ID
   

   PROJECT_ID ক্লাউড প্রকল্পের ID দিয়ে প্রতিস্থাপন করুন যা আপনি কুইকস্টার্টের জন্য ব্যবহার করেছেন। আপনি ড্যাশবোর্ড পৃষ্ঠায় Google ক্লাউড কনসোলে ক্লাউড প্রকল্প আইডি খুঁজে পেতে পারেন।

পরবর্তী পদক্ষেপ

আপনার Google Workspace অ্যাড-অনে আরও কার্যকারিতা যোগ করতে, নিম্নলিখিত নির্দেশিকাগুলি পড়ুন:

• যেকোনো কোডিং ভাষায় একটি অ্যাড-অন তৈরি করুন
• স্মার্ট চিপগুলির সাথে লিঙ্কগুলির পূর্বরূপ দেখুন