Quickstart: যেকোনো কোডিং ভাষায় একটি অ্যাড-অন তৈরি করুন

Apps স্ক্রিপ্ট ব্যবহার না করে ক্লাউড ফাংশনে একটি Google Workspace অ্যাড-অন তৈরি করুন।

উদ্দেশ্য

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

পূর্বশর্ত

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

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

    gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
    
  2. একটি খালি ডিরেক্টরিতে, নিম্নলিখিত নমুনা কোড দিয়ে function.js ফাইল তৈরি করুন:

    /**
     * Google 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
    
  4. ফাংশন স্থাপন করা হয়েছে যাচাই করুন:

    gcloud functions call loadHomePage
    

অ্যাড-অন চালু করতে Google কল করুন

  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
    

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

  1. নিয়োজিত ফাংশনের URL পান:

    gcloud functions describe loadHomePage
    
  2. নিচের নমুনা কোড দিয়ে 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": {}
      }
    }
    
  3. স্থাপনা তৈরি করুন:

    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 প্রতিস্থাপন করুন। আপনি ড্যাশবোর্ড পৃষ্ঠায় ক্লাউড কনসোলে প্রকল্প আইডি খুঁজে পেতে পারেন।