এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Node.js-এর সাহায্যে একটি Google Workspace অ্যাড-অন তৈরি করুন

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

দ্রষ্টব্য: এই কুইকস্টার্টে, আমরা একটি Google Workspace অ্যাড-অন তৈরি করতে ক্লাউড ফাংশন ব্যবহার করি। অ্যাপস স্ক্রিপ্টের বাইরে একটি বৈশিষ্ট্য সমৃদ্ধ অ্যাড-অন তৈরি করতে, ক্লাউড ফাংশনের পরিবর্তে ক্লাউড রান ব্যবহার করার কথা বিবেচনা করুন। একটি Google Workspace অ্যাড-অন তৈরি করতে ক্লাউড রান ব্যবহার করার টিউটোরিয়ালের জন্য, নিম্নলিখিত কোডল্যাবটি দেখুন: Node.js এবং ক্লাউড রান দিয়ে একটি Google Workspace অ্যাড-অন তৈরি করুন

উদ্দেশ্য

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

পূর্বশর্ত

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

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

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

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

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

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

Google ক্লাউড কনসোলে, মেনু > এ যান > ব্র্যান্ডিং ।
ব্র্যান্ডিং এ যান
আপনি যদি ইতিমধ্যেই কনফিগার করে থাকেন , আপনি ব্র্যান্ডিং , দর্শক এবং ডেটা অ্যাক্সেসে নিম্নলিখিত OAuth সম্মতি স্ক্রীন সেটিংস কনফিগার করতে পারেন৷ আপনি যদি একটি বার্তা দেখতে পারেন যা বলে এখনো কনফিগার করা হয়নি , Get Started এ ক্লিক করুন:

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

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

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

গুগল ক্লাউড কনসোল থেকে, ক্লাউড শেল সক্রিয় করুন ক্লিক করুন .
ক্লাউড শেল সক্রিয় করুন
ক্লাউড শেল টার্মিনাল Google ক্লাউড কনসোলের নীচের ফলকে একটি সেশন খোলে এবং চালু করে।
ক্লাউড শেলের সাথে প্রভিশন এবং সংযোগ করতে অনুমোদন ক্লিক করুন।

ক্লাউড শেল টার্মিনালে, ক্লাউড ফাংশন API, ক্লাউড বিল্ড API, Google Workspace অ্যাড-অন API এবং Compute Engine API চালু করুন:

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

ক্লিক করে ক্লাউড শেল এডিটর চালু করুন ক্লাউড শেল উইন্ডোর টুলবারে এডিটর খুলুন ।
এই অন্তর্নির্মিত কোড সম্পাদক একই পরিবেশে ফাইলগুলি দেখার এবং সম্পাদনা করার সুবিধা প্রদান করে যেখানে প্রকল্পগুলি তৈরি এবং স্থাপন করা হয়।

খালি ডিরেক্টরিতে, নিম্নলিখিত নমুনা কোড দিয়ে 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"
                     }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  };
}

একই ডিরেক্টরিতে, নিম্নলিখিত নমুনা কোড সহ package.json ফাইলটি তৈরি করুন:
```
{
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  }
}
```
ক্লিক করে ক্লাউড শেল টার্মিনালে ফিরে যান টার্মিনাল খুলুন ।
কম্পিউট ইঞ্জিন ডিফল্ট পরিষেবা অ্যাকাউন্টে Cloud Build Service Account ভূমিকা ( roles/cloudbuild.builds.builder ) যুক্ত করুন৷
প্রথমে, পরিষেবা অ্যাকাউন্টের অনুমতি সেটআপ করুন:
```
export PROJECT_ID=$(gcloud config get project)
export SERVICE_ACCOUNT_NAME=$(gcloud compute project-info describe \
  --format="value(defaultServiceAccount)")
```
এর পরে, অনুপস্থিত পরিষেবা অ্যাকাউন্টের অনুমতি দিন:
```
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
  --role="roles/cloudbuild.builds.builder"
```
ফাংশন স্থাপন করতে নিম্নলিখিত কমান্ডটি চালান:
```
gcloud functions deploy loadHomePage --runtime nodejs22 --trigger-http
```
অনুরোধ করা হলে, নির্দিষ্ট করুন যে আপনি ফাংশনের অননুমোদিত আহ্বানের অনুমতি দেবেন না। ফাংশনটি স্থাপন করতে কয়েক মিনিট সময় লাগতে পারে।

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

অ্যাড-অনের জন্য পরিষেবা অ্যাকাউন্ট ইমেল খুঁজুন:
```
gcloud workspace-add-ons get-authorization
```
পরিষেবা অ্যাকাউন্টটিকে cloudfunctions.invoker ভূমিকা মঞ্জুর করুন৷ পূর্ববর্তী ধাপ থেকে serviceAccountEmail ফিল্ড দিয়ে SERVICE_ACCOUNT_EMAIL প্রতিস্থাপন করুন।
```
gcloud functions add-iam-policy-binding loadHomePage \
   --role roles/cloudfunctions.invoker \
   --member serviceAccount:SERVICE_ACCOUNT_EMAIL
```
নিয়োজিত ফাংশনের URL পান। URL পেতে, নিম্নলিখিত কমান্ডটি চালান এবং httpsTrigger বিভাগের অধীনে url ক্ষেত্রটি সন্ধান করুন:
```
gcloud functions describe loadHomePage
```
ক্লিক করে ক্লাউড শেল এডিটরে ফিরে যান সম্পাদক খুলুন ।

package.json মতো একই ডিরেক্টরিতে, নিম্নলিখিত নমুনা কোড দিয়ে 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": {},
    "httpOptions": {
      "granularOauthPermissionSupport": "OPT_IN"
    }
  }
}

স্থাপনা তৈরি করতে ক্লাউড শেল টার্মিনালে ফিরে যান:
```
gcloud workspace-add-ons deployments create quickstart \
   --deployment-file=deployment.json
```

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

ডেভেলপমেন্ট মোডে স্থাপনা ইনস্টল করুন:
```
gcloud workspace-add-ons deployments install quickstart
```
অ্যাড-অন দেখতে Gmail খুলুন বা পুনরায় লোড করুন। ডানদিকে টুলবারে, একটি বীকার আইকন খুঁজুন।
অ্যাড-অন খুলতে আইকনে ক্লিক করুন। অনুরোধ করা হলে, অ্যাড-অন অনুমোদন করুন।

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

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

আপনার Google অ্যাকাউন্ট থেকে অ্যাড-অন আনইনস্টল করুন:
```
gcloud workspace-add-ons deployments uninstall quickstart
```
এই কুইকস্টার্টে ব্যবহৃত সংস্থানগুলির জন্য চার্জ এড়াতে, ক্লাউড প্রকল্পটি মুছুন:
```
gcloud projects delete PROJECT_ID
```
PROJECT_ID ক্লাউড প্রকল্পের ID দিয়ে প্রতিস্থাপন করুন যা আপনি কুইকস্টার্টের জন্য ব্যবহার করেছেন। আপনি ড্যাশবোর্ড পৃষ্ঠায় Google ক্লাউড কনসোলে ক্লাউড প্রকল্প আইডি খুঁজে পেতে পারেন।

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