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

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

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

উদ্দেশ্য

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

পূর্বশর্ত

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

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

গুগল ক্লাউড কনসোলে আপনার ক্লাউড প্রোজেক্ট খুলুন।

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

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

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

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

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

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

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

ক্লাউড শেলের সাথে সংযোগ স্থাপন এবং সংযোগ করতে অনুমোদনে ক্লিক করুন।
ক্লাউড শেল টার্মিনালে, ক্লাউড রান ফাংশন API, ক্লাউড বিল্ড API, গুগল ওয়ার্কস্পেস অ্যাড-অন API, কম্পিউট ইঞ্জিন API এবং ক্লাউড রান API চালু করুন:
```
gcloud services enable cloudfunctions.googleapis.com  \
                    cloudbuild.googleapis.com  \
                    gsuiteaddons.googleapis.com  \
                    compute.googleapis.com  \
                    run.googleapis.com
```
ক্লিক করে ক্লাউড শেল এডিটর চালু করুন ক্লাউড শেল উইন্ডোর টুলবারে এডিটর খুলুন ।
এই অন্তর্নির্মিত কোড সম্পাদকটি একই পরিবেশে ফাইলগুলি দেখার এবং সম্পাদনা করার সুবিধা প্রদান করে যেখানে প্রকল্পগুলি তৈরি এবং স্থাপন করা হয়।

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

/**
 * Cloud Run 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"
  }
}
```
ক্লিক করে ক্লাউড শেল টার্মিনালে ফিরে যান টার্মিনাল খুলুন ।
Compute Engine ডিফল্ট পরিষেবা অ্যাকাউন্টে 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 run deploy loadHomePage --runtime nodejs22 --trigger-http
```
যদি অনুরোধ করা হয়, তাহলে উল্লেখ করুন যে আপনি ফাংশনের অননুমোদিত আহ্বানগুলিকে অনুমতি দিচ্ছেন না। ফাংশনটি স্থাপন করতে কয়েক মিনিট সময় লাগতে পারে।

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

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

package.json এর মতো একই ডিরেক্টরিতে, নিম্নলিখিত নমুনা কোড দিয়ে deployment.json ফাইলটি তৈরি করুন। পূর্ববর্তী ধাপের deployed ফাংশনের 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 খুলুন বা পুনরায় লোড করুন। ডানদিকের টুলবারে, একটি বিকার আইকন খুঁজুন।
অ্যাড-অনটি খুলতে আইকনে ক্লিক করুন। যদি অনুরোধ করা হয়, তাহলে অ্যাড-অনটি অনুমোদন করুন।

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

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

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

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