HTTP Google Chat অ্যাপ তৈরি করা

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে যে কীভাবে Google Cloud পরিষেবা ব্যবহার করে HTTP Google Chat অ্যাপ তৈরি করতে হয়। Chat অ্যাপ তৈরি করতে, আপনি Cloud Run ফাংশন লেখেন এবং ডিপ্লয় করেন যা Chat অ্যাপ ব্যবহারকারীর মেসেজের উত্তর দেওয়ার জন্য ব্যবহার করে।

HTTP আর্কিটেকচারের মাধ্যমে, আপনি HTTP ব্যবহার করে Chat-কে Google Cloud বা কোনও অন-প্রিমিজেস সার্ভারের সাথে ইন্টিগ্রেট করার জন্য কনফিগার করেন, যা নিম্নলিখিত ডায়াগ্রামে দেখানো হয়েছে:

অন-প্রিমিজেস সার্ভারে ওয়েব পরিষেবা ব্যবহার করে এমন চ্যাট অ্যাপের আর্কিটেকচার।

আগের ডায়াগ্রামে, HTTP চ্যাট অ্যাপের সাথে ইন্টার‍্যাক্ট করা কোনও ব্যবহারকারীর তথ্যের ফ্লো নিচে উল্লেখ করা হল:

  1. কোনও ব্যবহারকারী Chat অ্যাপকে সরাসরি মেসেজ বা Chat স্পেসে মেসেজ পাঠান।
  2. Chat অ্যাপ লজিক আছে এমন কোনও ক্লাউড বা অন-প্রিমিজেস সিস্টেমে HTTP অনুরোধ পাঠানো হয়।
  3. ঐচ্ছিকভাবে, Chat অ্যাপের লজিক Google Workspace পরিষেবা (যেমন, Calendar ও Sheets), অন্যান্য Google পরিষেবা (যেমন, Maps, YouTube ও Vertex AI) অথবা অন্যান্য ওয়েব পরিষেবা (যেমন, প্রজেক্ট ম্যানেজমেন্ট সিস্টেম বা টিকেটিং টুল)-এর সাথে ইন্টিগ্রেট করা যেতে পারে।
  4. ওয়েব সার্ভার, Chat-এ থাকা Chat অ্যাপ পরিষেবায় একটি HTTP উত্তর ফেরত পাঠায়।
  5. উত্তরটি ব্যবহারকারীকে ডেলিভার করা হয়।
  6. বিকল্প হিসেবে, Chat অ্যাপ অ্যাসিঙ্ক্রোনাসভাবে মেসেজ পোস্ট করতে বা অন্যান্য অপারেশন পারফর্ম করতে Chat API-কে কল করতে পারে।

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

উদ্দেশ্য

  • আপনার এনভায়রনমেন্ট সেট-আপ করুন।
  • Cloud Run ফাংশন তৈরি ও ডিপ্লয় করা।
  • Chat অ্যাপ কনফিগার করুন।
  • অ্যাপটি টেস্ট করুন।

পূর্বশর্ত

এনভায়রনমেন্ট সেট-আপ করা

Google API ব্যবহার করার আগে, আপনাকে Google Cloud প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি Google Cloud প্রোজেক্টে এক বা একাধিক API চালু করতে পারবেন।
  • Google API Console-এ, Google Chat API, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API এবং Cloud Run API চালু করুন।

    API চালু করুন

Cloud Run ফাংশন তৈরি ও ডিপ্লয় করা

প্রেরকের ডিসপ্লে নাম ও অবতার ছবি সহ Chat কার্ড জেনারেট করে এমন Cloud Run ফাংশন তৈরি ও ডেপ্লয় করুন। Chat অ্যাপ কোনও মেসেজ পেলে, এটি ফাংশনটি রান করে এবং কার্ডের মাধ্যমে উত্তর দেয়।

আপনার Chat অ্যাপের জন্য ফাংশন তৈরি ও ডেপ্লয় করতে, নিচে উল্লেখ করা ধাপগুলি সম্পূর্ণ করুন:

Node.js

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনার Chat অ্যাপের জন্য প্রোজেক্ট বেছে নেওয়া হয়েছে কিনা দেখে নিন।

  2. ফাংশন লেখো বিকল্পে ক্লিক করো।

  3. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট-আপ করুন:

    1. পরিষেবার নাম ফিল্ডে, addonchatapp লিখুন।
    2. অঞ্চল তালিকা থেকে একটি অঞ্চল বেছে নিন।
    3. রানটাইম তালিকা থেকে, Node.js-এর সবচেয়ে সাম্প্রতিক ভার্সন বেছে নিন।
    4. যাচাইকরণ বিভাগে, যাচাইকরণ প্রয়োজন বিকল্প বেছে নিন।
    5. তৈরি করুন বিকল্পে ক্লিক করুন এবং Cloud Run-কে পরিষেবা তৈরি করতে দিন। কনসোল আপনাকে সোর্স ট্যাবে রিডাইরেক্ট করে।
  4. সোর্স ট্যাবে:

    1. এন্ট্রি পয়েন্টে গিয়ে ডিফল্ট টেক্সট মুছে দিয়ে avatarApp লিখুন।
    2. index.js-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:
    node/chat/avatar-app/index.js
    import { http } from '@google-cloud/functions-framework';
    
    // The ID of the slash command "/about".
    // You must use the same ID in the Google Chat API configuration.
    const ABOUT_COMMAND_ID = 1;
    
    /**
     * Handle requests from Google Workspace add on
     *
     * @param {Object} req Request sent by Google Chat
     * @param {Object} res Response to be sent back to Google Chat
     */
    http('avatarApp', (req, res) => {
      const chatEvent = req.body.chat;
      let message;
      if (chatEvent.appCommandPayload) {
        message = handleAppCommand(chatEvent);
      } else {
        message = handleMessage(chatEvent);
      }
      res.send({ hostAppDataAction: { chatDataAction: { createMessageAction: {
        message: message
      }}}});
    });
    
    /**
     * Responds to an APP_COMMAND event in Google Chat.
     *
     * @param {Object} event the event object from Google Chat
     * @return the response message object.
     */
    function handleAppCommand(event) {
      switch (event.appCommandPayload.appCommandMetadata.appCommandId) {
        case ABOUT_COMMAND_ID:
          return {
            text: 'The Avatar app replies to Google Chat messages.'
          };
      }
    }
    
    /**
     * Responds to a MESSAGE event in Google Chat.
     *
     * @param {Object} event the event object from Google Chat
     * @return the response message object.
     */
    function handleMessage(event) {
      // Stores the Google Chat user as a variable.
      const chatUser = event.messagePayload.message.sender;
      const displayName = chatUser.displayName;
      const avatarUrl = chatUser.avatarUrl;
      return {
        text: 'Here\'s your avatar',
        cardsV2: [{
          cardId: 'avatarCard',
          card: {
            name: 'Avatar Card',
            header: {
              title: `Hello ${displayName}!`,
            },
            sections: [{ widgets: [{
              textParagraph: { text: 'Your avatar picture: ' }
            }, {
              image: { imageUrl: avatarUrl }
            }]}]
          }
        }]
      };
    }
    1. সেভ করে আবার ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

Python

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনার Chat অ্যাপের জন্য প্রোজেক্ট বেছে নেওয়া হয়েছে কিনা দেখে নিন।

  2. ফাংশন লেখো বিকল্পে ক্লিক করো।

  3. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট-আপ করুন:

    1. পরিষেবার নাম ফিল্ডে, addonchatapp লিখুন।
    2. অঞ্চল তালিকা থেকে একটি অঞ্চল বেছে নিন।
    3. রানটাইম তালিকা থেকে, Python-এর সবচেয়ে সাম্প্রতিক ভার্সন বেছে নিন।
    4. যাচাইকরণ বিভাগে, যাচাইকরণ প্রয়োজন বিকল্প বেছে নিন।
    5. তৈরি করুন বিকল্পে ক্লিক করুন এবং Cloud Run-কে পরিষেবা তৈরি করতে দিন। কনসোল আপনাকে সোর্স ট্যাবে রিডাইরেক্ট করে।
  4. সোর্স ট্যাবে:

    1. এন্ট্রি পয়েন্টে গিয়ে ডিফল্ট টেক্সট মুছে দিয়ে avatar_app লিখুন।
    2. main.py-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:
    python/chat/avatar-app/main.py
    from typing import Any, Mapping
    
    import flask
    import functions_framework
    
    # The ID of the slash command "/about".
    # You must use the same ID in the Google Chat API configuration.
    ABOUT_COMMAND_ID = 1
    
    @functions_framework.http
    def avatar_app(req: flask.Request) -> Mapping[str, Any]:
      """Handle requests from Google Workspace add on
    
      Args:
        flask.Request req: the request sent by Google Chat
    
      Returns:
        Mapping[str, Any]: the response to be sent back to Google Chat
      """
      chat_event = req.get_json(silent=True)["chat"]
      if chat_event and "appCommandPayload" in chat_event:
        message = handle_app_command(chat_event)
      else:
        message = handle_message(chat_event)
      return { "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
          "message": message
      }}}}
    
    def handle_app_command(event: Mapping[str, Any]) -> Mapping[str, Any]:
      """Responds to an APP_COMMAND event in Google Chat.
    
      Args:
        Mapping[str, Any] event: the event object from Google Chat
    
      Returns:
        Mapping[str, Any]: the response message object.
      """
      if event["appCommandPayload"]["appCommandMetadata"]["appCommandId"] == ABOUT_COMMAND_ID:
        return {
          "text": "The Avatar app replies to Google Chat messages.",
        }
      return {}
    
    def handle_message(event: Mapping[str, Any]) -> Mapping[str, Any]:
      """Responds to a MESSAGE event in Google Chat.
    
      Args:
        Mapping[str, Any] event: the event object from Google Chat
    
      Returns:
        Mapping[str, Any]: the response message object.
      """
      # Stores the Google Chat user as a variable.
      chat_user = event["messagePayload"]["message"]["sender"]
      display_name = chat_user.get("displayName", "")
      avatar_url = chat_user.get("avatarUrl", "")
      return {
        "text": "Here's your avatar",
        "cardsV2": [{
          "cardId": "avatarCard",
          "card": {
            "name": "Avatar Card",
            "header": {
              "title": f"Hello {display_name}!"
            },
            "sections": [{ "widgets": [
              { "textParagraph": { "text": "Your avatar picture:" }},
              { "image": { "imageUrl": avatar_url }},
            ]}]
          }
        }]
      }
    1. সেভ করে আবার ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

Java

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনার Chat অ্যাপের জন্য প্রোজেক্ট বেছে নেওয়া হয়েছে কিনা দেখে নিন।

  2. ফাংশন লেখো বিকল্পে ক্লিক করো।

  3. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট-আপ করুন:

    1. পরিষেবার নাম ফিল্ডে, addonchatapp লিখুন।
    2. অঞ্চল তালিকা থেকে একটি অঞ্চল বেছে নিন।
    3. রানটাইম তালিকা থেকে, Java-র সবচেয়ে সাম্প্রতিক ভার্সন বেছে নিন।
    4. যাচাইকরণ বিভাগে, যাচাইকরণ প্রয়োজন বিকল্প বেছে নিন।
    5. তৈরি করুন বিকল্পে ক্লিক করুন এবং Cloud Run-কে পরিষেবা তৈরি করতে দিন। কনসোল আপনাকে সোর্স ট্যাবে রিডাইরেক্ট করে।
  4. সোর্স ট্যাবে:

    1. এন্ট্রি পয়েন্ট বিকল্পে গিয়ে ডিফল্ট টেক্সট মুছে দিয়ে App লিখুন।
    2. ডিফল্ট Java ফাইলের নাম পরিবর্তন করে src/main/java/com/google/chat/avatar/App.java করুন।
    3. App.java-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:
    java/chat/avatar-app/src/main/java/com/google/chat/avatar/App.java
    package com.google.chat.avatar;
    
    import com.google.api.services.chat.v1.model.CardWithId;
    import com.google.api.services.chat.v1.model.GoogleAppsCardV1Card;
    import com.google.api.services.chat.v1.model.GoogleAppsCardV1CardHeader;
    import com.google.api.services.chat.v1.model.GoogleAppsCardV1Image;
    import com.google.api.services.chat.v1.model.GoogleAppsCardV1Section;
    import com.google.api.services.chat.v1.model.GoogleAppsCardV1TextParagraph;
    import com.google.api.services.chat.v1.model.GoogleAppsCardV1Widget;
    import com.google.api.services.chat.v1.model.Message;
    import com.google.cloud.functions.HttpFunction;
    import com.google.cloud.functions.HttpRequest;
    import com.google.cloud.functions.HttpResponse;
    import com.google.gson.Gson;
    import com.google.gson.JsonObject;
    import java.util.List;
    
    public class App implements HttpFunction {
      // The ID of the slash command "/about".
      // You must use the same ID in the Google Chat API configuration.
      private static final int ABOUT_COMMAND_ID = 1;
    
      private static final Gson gson = new Gson();
    
      /**
       * Handle requests from Google Workspace add on
       * 
       * @param request the request sent by Google Chat
       * @param response the response to be sent back to Google Chat
       */
      @Override
      public void service(HttpRequest request, HttpResponse response) throws Exception {
        JsonObject event = gson.fromJson(request.getReader(), JsonObject.class);
        JsonObject chatEvent = event.getAsJsonObject("chat");
        Message message;
        if (chatEvent.has("appCommandPayload")) {
          message = handleAppCommand(chatEvent);
        } else {
          message = handleMessage(chatEvent);
        }
        JsonObject createMessageAction = new JsonObject();
        createMessageAction.add("message", gson.fromJson(gson.toJson(message), JsonObject.class));
        JsonObject chatDataAction = new JsonObject();
        chatDataAction.add("createMessageAction", createMessageAction);
        JsonObject hostAppDataAction = new JsonObject();
        hostAppDataAction.add("chatDataAction", chatDataAction);
        JsonObject dataActions = new JsonObject();
        dataActions.add("hostAppDataAction", hostAppDataAction);
        response.getWriter().write(gson.toJson(dataActions));
      }
    
      /**
       * Handles an APP_COMMAND event in Google Chat.
       *
       * @param event the event object from Google Chat
       * @return the response message object.
       */
      private Message handleAppCommand(JsonObject event) throws Exception {
        switch (event.getAsJsonObject("appCommandPayload")
          .getAsJsonObject("appCommandMetadata").get("appCommandId").getAsInt()) {
          case ABOUT_COMMAND_ID:
            return new Message()
              .setText("The Avatar app replies to Google Chat messages.");
          default:
            return null;
        }
      }
    
      /**
       * Handles a MESSAGE event in Google Chat.
       *
       * @param event the event object from Google Chat
       * @return the response message object.
       */
      private Message handleMessage(JsonObject event) throws Exception {
        // Stores the Google Chat user as a variable.
        JsonObject chatUser = event.getAsJsonObject("messagePayload").getAsJsonObject("message").getAsJsonObject("sender");
        String displayName = chatUser.has("displayName") ? chatUser.get("displayName").getAsString() : "";
        String avatarUrl = chatUser.has("avatarUrl") ? chatUser.get("avatarUrl").getAsString() : "";
        return new Message()
          .setText("Here's your avatar")
          .setCardsV2(List.of(new CardWithId()
            .setCardId("avatarCard")
            .setCard(new GoogleAppsCardV1Card()
              .setName("Avatar Card")
              .setHeader(new GoogleAppsCardV1CardHeader()
                .setTitle(String.format("Hello %s!", displayName)))
              .setSections(List.of(new GoogleAppsCardV1Section().setWidgets(List.of(
                new GoogleAppsCardV1Widget().setTextParagraph(new GoogleAppsCardV1TextParagraph()
                  .setText("Your avatar picture:")),
                new GoogleAppsCardV1Widget()
                  .setImage(new GoogleAppsCardV1Image().setImageUrl(avatarUrl)))))))));
      }
    }
  5. pom.xml-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

    java/chat/avatar-app/pom.xml
    <project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
    
      <groupId>com.google.chat</groupId>
      <artifactId>avatar-app</artifactId>
      <version>1.0-SNAPSHOT</version>
    
      <properties>
        <maven.compiler.target>17</maven.compiler.target>
        <maven.compiler.source>17</maven.compiler.source>
      </properties>
    
      <dependencies>
        <dependency>
          <groupId>com.google.cloud.functions</groupId>
          <artifactId>functions-framework-api</artifactId>
          <version>1.1.4</version>
        </dependency>
        <dependency>
          <groupId>com.google.code.gson</groupId>
          <artifactId>gson</artifactId>
          <version>2.9.1</version>
        </dependency>
        <dependency>
          <groupId>com.google.apis</groupId>
          <artifactId>google-api-services-chat</artifactId>
          <version>v1-rev20230115-2.0.0</version>
        </dependency>
      </dependencies>
    
      <build>
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
            <excludes>
              <exclude>.google/</exclude>
            </excludes>
            </configuration>
          </plugin>
        </plugins>
      </build>
    </project>
    1. সেভ করে আবার ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

Cloud Run পরিষেবার বিবরণ পৃষ্ঠা খুলে যায়। ফাংশনটি ডেপ্লয় হওয়া পর্যন্ত অপেক্ষা করুন।

Chat অ্যাপ কনফিগার করা

Cloud Run ফাংশন ডেপ্লয় করার পরে, Google Chat অ্যাপ কনফিগার ও ডেপ্লয় করতে এইসব ধাপ অনুসরণ করুন:

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনি যে প্রোজেক্টের জন্য Cloud Run চালু করেছেন সেটি বেছে নেওয়া হয়েছে কিনা ভাল করে দেখে নিন।

  2. ফাংশনের তালিকায়, addonchatapp বিকল্পে ক্লিক করুন।

  3. পরিষেবার বিবরণ পৃষ্ঠায়, ফাংশনের URL কপি করুন। URL-এর শেষে run.app আছে।

  4. Google Cloud সার্চ ফিল্ডে, "Google Chat API" সার্চ করুন, তারপর Google Chat API-তে ক্লিক করুন এবং ম্যানেজ করুন বিকল্পে ক্লিক করুন।

    Chat API-তে যান

  5. কনফিগারেশন বিকল্পে ক্লিক করে Google Chat অ্যাপ সেট-আপ করুন:

    1. অ্যাপের নাম বিকল্পে Quickstart App লিখুন।
    2. অবতার URL-এ গিয়ে https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
    3. বিবরণ বিভাগে, Quickstart app লিখুন।
    4. কার্যকারিতা বিকল্পের মধ্যে, স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।
    5. কানেকশন সেটিংস বিকল্পের মধ্যে, HTTP এন্ডপয়েন্ট URL বিকল্প বেছে নিন।
    6. ট্রিগার বিকল্পের মধ্যে, সব ট্রিগারের জন্য একটি সাধারণ HTTP এন্ডপয়েন্ট URL ব্যবহার করুন বিকল্প বেছে নিন এবং Cloud Run ফাংশন ট্রিগারের URLটি বক্সে পেস্ট করুন।
    7. দৃশ্যমানতা বিকল্পের মধ্যে, বেছে নিন আপনার ডোমেনে নির্দিষ্ট ব্যক্তি ও গ্রুপের জন্য এই Google Chat অ্যাপ উপলভ্য করুন এবং আপনার ইমেল আইডি লিখুন।
    8. লগ বিকল্পের মধ্যে, লগিংয়ে লগ সংক্রান্ত সমস্যা বিকল্প বেছে নিন।
  6. সেভ করুন বিকল্পে ক্লিক করুন।

  7. কানেকশন সেটিংস বিকল্পের মধ্যে, পরিষেবা অ্যাকাউন্টের ইমেল কপি করুন। আপনার ফাংশন ইনভোক করার জন্য Chat অ্যাপকে অনুমতি দেওয়ার সময় এই ইমেল আইডি প্রয়োজন।

এরপরে, Cloud Run ফাংশন ইনভোক করার জন্য Chat অ্যাপকে অনুমোদন দিন।

আপনার ফাংশন ইনভোক করার জন্য Google Chat-কে অনুমতি দিন

আপনার ফাংশন ইনভোক করার জন্য Google Chat-কে অনুমোদন দিতে, Cloud Run Invoker ভূমিকায় Chat অ্যাপ পরিষেবা অ্যাকাউন্ট যোগ করুন।

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

  2. Cloud Run পরিষেবার তালিকায়, গ্রহণকারী ফাংশনের পাশে থাকা চেকবক্স বেছে নিন। (ফাংশনে ক্লিক করবেন না।)

  3. অনুমতি বিকল্পে ক্লিক করুন। অনুমতি প্যানেল খুলে যায়।

  4. প্রিন্সিপাল যোগ করুন বিকল্পে ক্লিক করুন।

  5. নতুন প্রিন্সিপাল বিকল্পে, আপনার Chat অ্যাপের সাথে যুক্ত পরিষেবা অ্যাকাউন্টের ইমেল আইডি লিখুন।

    পরিষেবা অ্যাকাউন্টের ইমেল আইডি Chat API কনফিগারেশন পৃষ্ঠায়, কানেকশন সেটিংস > HTTP এন্ডপয়েন্ট URL > পরিষেবা অ্যাকাউন্টের ইমেল বিকল্পের মধ্যে আছে:

    Chat API কনফিগারেশনে যান

  6. একটি ভূমিকা বেছে নিন বিকল্পে গিয়ে Cloud Run > Cloud Run Invoker বিকল্প বেছে নিন।

  7. সেভ করুন বিকল্পে ক্লিক করুন।

Chat অ্যাপ, Chat-এ মেসেজ গ্রহণ করতে ও উত্তর দিতে প্রস্তুত।

আপনার Chat অ্যাপ পরীক্ষা করা

আপনার Chat অ্যাপ পরীক্ষা করতে, Chat অ্যাপের মাধ্যমে সরাসরি মেসেজ স্পেস খুলুন এবং একটি মেসেজ পাঠান:

  1. আপনি বিশ্বস্ত পরীক্ষক হিসেবে নিজেকে যোগ করার সময় যে Google Workspace অ্যাকাউন্ট প্রদান করেছিলেন সেটি ব্যবহার করে Google Chat খুলুন।

    Google Chat-এ যান

  2. নতুন চ্যাট বিকল্পে ক্লিক করুন।
  3. ১ বা একাধিক লোকজনকে যোগ করুন ফিল্ডে, আপনার Chat অ্যাপের নাম টাইপ করুন।
  4. ফলাফল থেকে আপনার Chat অ্যাপ বেছে নিন। সরাসরি মেসেজ খুলে যায়।

  5. অ্যাপের সাথে নতুন সরাসরি মেসেজে, Hello টাইপ করে enter প্রেস করুন।

Chat অ্যাপের মেসেজে একটি কার্ড থাকে যা প্রেরকের নাম ও অবতার ছবি দেখায়, যেমন নিচের ছবিতে দেখানো হয়েছে:

প্রেরকের ডিসপ্লে নাম ও অবতার সহ কার্ডের মাধ্যমে চ্যাট অ্যাপের উত্তর দেওয়া
ছবি

বিশ্বস্ত পরীক্ষক যোগ করতে এবং ইন্ট্যার‍্যাক্টিভ ফিচার পরীক্ষা করা সম্পর্কে আরও জানতে, Google Chat অ্যাপের জন্য ইন্ট্যার‍্যাক্টিভ ফিচার পরীক্ষা করুন দেখুন।

সমস্যার সমাধান করুন

Google Chat অ্যাপ বা কার্ড কোনও সমস্যার মেসেজ দেখালে, Chat ইন্টারফেস "কিছু সমস্যা হয়েছে" লেখা মেসেজ দেখায়। অথবা "আপনার অনুরোধ প্রসেস করা যায়নি" কখনও কখনও Chat UI কোনও সমস্যার মেসেজ না দেখালেও, Chat অ্যাপ বা কার্ড অপ্রত্যাশিত ফলাফল দেয়; যেমন, কার্ড মেসেজ দেখানো নাও হতে পারে।

যদিও Chat UI-তে কোনও সমস্যার মেসেজ নাও দেখাতে পারে, Chat অ্যাপের জন্য সমস্যা লগ করার সুবিধা চালু করা থাকলে, সমস্যার বিবরণ সহ মেসেজ ও লগ ডেটা আপনাকে সমস্যা সমাধান করতে সাহায্য করার জন্য উপলভ্য থাকে। দেখতে, ডিবাগ করতে এবং সমস্যার সমাধান করতে সাহায্য পেতে, Google Chat সংক্রান্ত সমস্যার সমাধান ও তা ঠিক করা দেখুন।

অপ্রয়োজনীয়গুলি মুছুন

এই টিউটোরিয়ালে ব্যবহৃত রিসোর্সের জন্য আপনার Google Cloud অ্যাকাউন্টে চার্জ যাতে না লাগে, তার জন্য আমরা Cloud প্রোজেক্টটি মুছে দেওয়ার সাজেস্ট করি।

  1. Google API কনসোলে, রিসোর্স ম্যানেজ করুন পৃষ্ঠায় যান। মেনু > IAM ও অ্যাডমিন > রিসোর্স ম্যানেজ করুন বিকল্পে ক্লিক করুন।

    রিসোর্স ম্যানেজারে যান

  2. প্রোজেক্টের তালিকা থেকে, যে প্রোজেক্টটি মুছতে চান সেটি বেছে নিন এবং তারপরে মুছুন বিকল্পে ক্লিক করুন।
  3. ডায়ালগে, প্রোজেক্ট আইডি টাইপ করুন এবং তারপর প্রোজেক্ট মুছে দিতে বন্ধ করুন বিকল্পে ক্লিক করুন ।

অ্যাড-অন নয় এমন চ্যাট অ্যাপ: HTTP Google Chat অ্যাপ তৈরি করা

Google Workspace অ্যাড-অন নয় এমন Chat অ্যাপ তৈরি করতে, Cloud Run ফাংশন ডিপ্লয় করতে, ইনভোকেশন অনুমতি দিতে এবং অ্যাড-অন নয় এমন Chat অ্যাপ কনফিগার করতে, এইসব ধাপ অনুসরণ করুন।

অ্যাড-অন নয় এমন চ্যাট অ্যাপের জন্য Cloud Run ফাংশন তৈরি ও ডিপ্লয় করা

Node.js

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনার Chat অ্যাপের জন্য প্রোজেক্ট বেছে নেওয়া হয়েছে কিনা দেখে নিন।

  2. ফাংশন লেখো বিকল্পে ক্লিক করো।

  3. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট-আপ করুন:

    1. পরিষেবার নাম ফিল্ডে, quickstartchatapp লিখুন।
    2. অঞ্চল তালিকা থেকে একটি অঞ্চল বেছে নিন।
    3. রানটাইম তালিকা থেকে, Node.js-এর সবচেয়ে সাম্প্রতিক ভার্সন বেছে নিন।
    4. যাচাইকরণ বিভাগে, যাচাইকরণ প্রয়োজন বিকল্প বেছে নিন।
    5. তৈরি করুন বিকল্পে ক্লিক করুন এবং Cloud Run-কে পরিষেবা তৈরি করতে দিন। কনসোল আপনাকে সোর্স ট্যাবে রিডাইরেক্ট করে।
  4. সোর্স ট্যাবে:

    1. এন্ট্রি পয়েন্টে গিয়ে ডিফল্ট টেক্সট মুছে দিয়ে avatarApp লিখুন।
    2. index.js-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

      node/avatar-app/index.js
      const functions = require('@google-cloud/functions-framework');
      
      // Command IDs (configure these in Google Chat API)
      const ABOUT_COMMAND_ID = 1; // ID for the "/about" slash command
      const HELP_COMMAND_ID = 2; // ID for the "Help" quick command
      
      /**
       * Google Cloud Function that handles HTTP requests from Google Chat.
       *
       * @param {Object} req - The HTTP request object sent from Google Chat.
       * @param {Object} res - The HTTP response object.
       */
      functions.http('avatarApp', (req, res) => {
        const event = req.body;
      
        if (event.appCommandMetadata) {
          handleAppCommands(event, res);
        } else {
          handleRegularMessage(event, res);
        }
      });
      
      /**
       * Handles slash and quick commands.
       *
       * @param {Object} event - The Google Chat event.
       * @param {Object} res - The HTTP response object.
       */
      function handleAppCommands(event, res) {
        const {appCommandId, appCommandType} = event.appCommandMetadata;
      
        switch (appCommandId) {
          case ABOUT_COMMAND_ID:
            return res.send({
              privateMessageViewer: event.user,
              text: 'The Avatar app replies to Google Chat messages.'
            });
          case HELP_COMMAND_ID:
            return res.send({
              privateMessageViewer: event.user,
              text: 'The Avatar app replies to Google Chat messages.'
            });
        }
      }
      
      /**
       * Handles regular messages (not commands).
       *
       * @param {Object} event - The Google Chat event.
       * @param {Object} res - The HTTP response object.
       */
      function handleRegularMessage(event, res) {
        const messageData = createMessage(event.user);
        res.send(messageData);
      }
      
      /**
       * Creates a card message with the user's avatar.
       *
       * @param {Object} user - The user who sent the message.
       * @param {string} user.displayName - The user's display name.
       * @param {string} user.avatarUrl - The URL of the user's avatar.
       * @return {Object} - The card message object.
       */
      function createMessage({displayName, avatarUrl}) {
        return {
          text: 'Here\'s your avatar',
          cardsV2: [{
            cardId: 'avatarCard',
            card: {
              name: 'Avatar Card',
              header: {
                title: `Hello ${displayName}!`,
              },
              sections: [{
                widgets: [
                  {textParagraph: {text: 'Your avatar picture:'}},
                  {image: {imageUrl: avatarUrl}},
                ],
              }],
            },
          }],
        };
      }

    3. সেভ করে আবার ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

Python

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনার Chat অ্যাপের জন্য প্রোজেক্ট বেছে নেওয়া হয়েছে কিনা দেখে নিন।

  2. ফাংশন লেখো বিকল্পে ক্লিক করো।

  3. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট-আপ করুন:

    1. পরিষেবার নাম ফিল্ডে, quickstartchatapp লিখুন।
    2. অঞ্চল তালিকা থেকে একটি অঞ্চল বেছে নিন।
    3. রানটাইম তালিকা থেকে, Python-এর সবচেয়ে সাম্প্রতিক ভার্সন বেছে নিন।
    4. যাচাইকরণ বিভাগে, যাচাইকরণ প্রয়োজন বিকল্প বেছে নিন।
    5. তৈরি করুন বিকল্পে ক্লিক করুন এবং Cloud Run-কে পরিষেবা তৈরি করতে দিন। কনসোল আপনাকে সোর্স ট্যাবে রিডাইরেক্ট করে।
  4. সোর্স ট্যাবে:

    1. এন্ট্রি পয়েন্টে গিয়ে ডিফল্ট টেক্সট মুছে দিয়ে avatar_app লিখুন।
    2. main.py-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

      python/avatar-app/main.py
      from typing import Any, Mapping
      
      import flask
      import functions_framework
      
      # Command IDs (configure these in Google Chat API)
      ABOUT_COMMAND_ID = 1  # ID for the "/about" slash command
      HELP_COMMAND_ID = 2  # ID for the "Help" quick command
      
      
      @functions_framework.http
      def avatar_app(req: flask.Request) -> Mapping[str, Any]:
          """Google Cloud Function that handles HTTP requests from Google Chat.
      
          Args:
              flask.Request: the request
      
          Returns:
              Mapping[str, Any]: the response
          """
          event = req.get_json(silent=True)
      
          if event and "appCommandMetadata" in event:
              return handle_app_commands(event)
          else:
              return handle_regular_message(event)
      
      
      def handle_app_commands(event: Mapping[str, Any]) -> Mapping[str, Any]:
          """Handles slash and quick commands.
      
          Args:
              Mapping[str, Any] event: The Google Chat event.
      
          Returns:
              Mapping[str, Any]: the response
          """
          app_command_id = event["appCommandMetadata"]["appCommandId"]
      
          if app_command_id == ABOUT_COMMAND_ID:
              return {
                  "privateMessageViewer": event["user"],
                  "text": "The Avatar app replies to Google Chat messages.",
              }
          elif app_command_id == HELP_COMMAND_ID:
              return {
                  "privateMessageViewer": event["user"],
                  "text": "The Avatar app replies to Google Chat messages.",
              }
          return {}
      
      
      
      
      def handle_regular_message(event: Mapping[str, Any]) -> Mapping[str, Any]:
          """Handles regular messages (not commands).
      
          Args:
              Mapping[str, Any] event: The Google Chat event.
      
          Returns:
              Mapping[str, Any]: the response
          """
      
          if not event or "user" not in event:
              return "Invalid request."
      
          message_data = create_message(event["user"])
          return message_data
      
      
      def create_message(user: Mapping[str, Any]) -> Mapping[str, Any]:
          """Creates a card message with the user's avatar.
      
          Args:
              Mapping[str, Any] user: The user who sent the message.
      
          Returns:
              Mapping[str, Any]: a card with the user's avatar.
          """
          display_name = user.get("displayName", "")
          avatar_url = user.get("avatarUrl", "")
      
          return {
              "text": "Here's your avatar",
              "cardsV2": [
                  {
                      "cardId": "avatarCard",
                      "card": {
                          "name": "Avatar Card",
                          "header": {"title": f"Hello {display_name}!"},
                          "sections": [
                              {
                                  "widgets": [
                                      {"textParagraph": {"text": "Your avatar picture:"}},
                                      {"image": {"imageUrl": avatar_url}},
                                  ]
                              }
                          ],
                      },
                  }
              ],
          }

    3. সেভ করে আবার ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

Java

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনার Chat অ্যাপের জন্য প্রোজেক্ট বেছে নেওয়া হয়েছে কিনা দেখে নিন।

  2. ফাংশন লেখো বিকল্পে ক্লিক করো।

  3. পরিষেবা তৈরি করুন পৃষ্ঠায়, আপনার ফাংশন সেট-আপ করুন:

    1. পরিষেবার নাম ফিল্ডে, quickstartchatapp লিখুন।
    2. অঞ্চল তালিকা থেকে একটি অঞ্চল বেছে নিন।
    3. রানটাইম তালিকা থেকে, Java-র সবচেয়ে সাম্প্রতিক ভার্সন বেছে নিন।
    4. যাচাইকরণ বিভাগে, যাচাইকরণ প্রয়োজন বিকল্প বেছে নিন।
    5. তৈরি করুন বিকল্পে ক্লিক করুন এবং Cloud Run-কে পরিষেবা তৈরি করতে দিন। কনসোল আপনাকে সোর্স ট্যাবে রিডাইরেক্ট করে।
  4. সোর্স ট্যাবে:

    1. এন্ট্রি পয়েন্টে গিয়ে ডিফল্ট টেক্সট মুছে দিয়ে App লিখুন।
    2. src/main/java/com/example/Example.java-এর নাম পরিবর্তন করে src/main/java/AvatarApp.java করুন।
    3. AvatarApp.java-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

      java/avatar-app/src/main/java/AvatarApp.java
      import com.google.api.services.chat.v1.model.CardWithId;
      import com.google.api.services.chat.v1.model.GoogleAppsCardV1Card;
      import com.google.api.services.chat.v1.model.GoogleAppsCardV1CardHeader;
      import com.google.api.services.chat.v1.model.GoogleAppsCardV1Image;
      import com.google.api.services.chat.v1.model.GoogleAppsCardV1Section;
      import com.google.api.services.chat.v1.model.GoogleAppsCardV1TextParagraph;
      import com.google.api.services.chat.v1.model.GoogleAppsCardV1Widget;
      import com.google.api.services.chat.v1.model.Message;
      import com.google.api.services.chat.v1.model.User;
      import com.google.cloud.functions.HttpFunction;
      import com.google.cloud.functions.HttpRequest;
      import com.google.cloud.functions.HttpResponse;
      import com.google.gson.Gson;
      import com.google.gson.JsonObject;
      import java.util.List;
      
      public class AvatarApp implements HttpFunction {
        private static final Gson gson = new Gson();
      
        // Command IDs (configure these in Google Chat API)
        private static final int ABOUT_COMMAND_ID = 1; // ID for the "/about" slash command
        private static final int HELP_COMMAND_ID = 2; // ID for the "Help" quick command
      
        @Override
        public void service(HttpRequest request, HttpResponse response) throws Exception {
          JsonObject event = gson.fromJson(request.getReader(), JsonObject.class);
      
          if (event.has("appCommandMetadata")) {
            handleAppCommands(event, response);
          } else {
            handleRegularMessage(event, response);
          }
        }
      
        /**
         * Handles slash and quick commands.
         *
         * @param event    The Google Chat event.
         * @param response The HTTP response object.
         */
        private void handleAppCommands(JsonObject event, HttpResponse response) throws Exception {
          int appCommandId = event.getAsJsonObject("appCommandMetadata").get("appCommandId").getAsInt();
      
          switch (appCommandId) {
            case ABOUT_COMMAND_ID:
              Message aboutMessage = new Message();
              aboutMessage.setText("The Avatar app replies to Google Chat messages.");
              aboutMessage.setPrivateMessageViewer(new User()
                  .setName(event.getAsJsonObject("user").get("name").getAsString()));
              response.getWriter().write(gson.toJson(aboutMessage));
              return;
            case HELP_COMMAND_ID:
              Message helpMessage = new Message();
              helpMessage.setText("The Avatar app replies to Google Chat messages.");
              helpMessage.setPrivateMessageViewer(new User()
                  .setName(event.getAsJsonObject("user").get("name").getAsString()));
              response.getWriter().write(gson.toJson(helpMessage));
              return;
          }
        }
      
        /**
         * Handles regular messages (not commands).
         *
         * @param event    The Google Chat event.
         * @param response The HTTP response object.
         */
        private void handleRegularMessage(JsonObject event, HttpResponse response) throws Exception {
      
          if (!event.has("user")) {
            response.getWriter().write("Invalid request.");
            return;
          }
      
          JsonObject user = event.getAsJsonObject("user");
          String displayName = user.has("displayName") ? user.get("displayName").getAsString() : "";
          String avatarUrl = user.has("avatarUrl") ? user.get("avatarUrl").getAsString() : "";
          Message message = createMessage(displayName, avatarUrl);
          response.getWriter().write(gson.toJson(message));
        }
      
        /**
         * Creates a card message with the user's avatar.
         *
         * @param displayName The user's display name.
         * @param avatarUrl   The URL of the user's avatar.
         * @return The card message object.
         */
        private Message createMessage(String displayName, String avatarUrl) {
          return new Message()
              .setText("Here's your avatar")
              .setCardsV2(List.of(new CardWithId()
                  .setCardId("avatarCard")
                  .setCard(new GoogleAppsCardV1Card()
                      .setName("Avatar Card")
                      .setHeader(new GoogleAppsCardV1CardHeader()
                          .setTitle(String.format("Hello %s!", displayName)))
                      .setSections(List.of(new GoogleAppsCardV1Section().setWidgets(List.of(
                          new GoogleAppsCardV1Widget()
                              .setTextParagraph(new GoogleAppsCardV1TextParagraph()
                                  .setText("Your avatar picture:")),
                          new GoogleAppsCardV1Widget()
                              .setImage(new GoogleAppsCardV1Image().setImageUrl(avatarUrl)))))))));
        }
      }

    4. pom.xml-এর কন্টেন্ট নিম্নলিখিত কোড দিয়ে পরিবর্তন করুন:

      java/avatar-app/pom.xml
      <project xmlns="http://maven.apache.org/POM/4.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
        <modelVersion>4.0.0</modelVersion>
      
        <groupId>gcfv2</groupId>
        <artifactId>avatar-app</artifactId>
        <version>0.0.1</version>
        <name>Avatar App</name>
      
        <properties>
          <maven.compiler.release>21</maven.compiler.release>
        </properties>
      
        <dependencies>
          <dependency>
            <groupId>com.google.cloud.functions</groupId>
            <artifactId>functions-framework-api</artifactId>
            <version>1.1.4</version>
          </dependency>
      
          <!-- https://mvnrepository.com/artifact/com.google.code.gson/gson -->
          <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.12.1</version>
          </dependency>
      
          <!-- https://mvnrepository.com/artifact/com.google.apis/google-api-services-chat -->
          <dependency>
            <groupId>com.google.apis</groupId>
            <artifactId>google-api-services-chat</artifactId>
            <version>v1-rev20250116-2.0.0</version>
          </dependency>
      
        </dependencies>
      
      </project>

    5. সেভ করে আবার ডেপ্লয় করুন বিকল্পে ক্লিক করুন।

আপনার ফাংশন ইনভোক করার জন্য Google Chat-কে অনুমতি দিন

আপনার ফাংশন ইনভোক করার জন্য Google Chat-কে অনুমোদন দিতে, Cloud Run Invoker ভূমিকা সহ Google Chat পরিষেবা অ্যাকাউন্ট যোগ করুন:

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

  2. Cloud Run পরিষেবার তালিকায়, গ্রহণকারী ফাংশনের পাশে থাকা চেকবক্স বেছে নিন। (ফাংশনে ক্লিক করবেন না।)

  3. অনুমতি বিকল্পে ক্লিক করুন। অনুমতি প্যানেল খুলে যায়।

  4. প্রিন্সিপাল যোগ করুন বিকল্পে ক্লিক করুন।

  5. নতুন মালিক বিকল্পে chat@system.gserviceaccount.com লিখুন।

  6. একটি ভূমিকা বেছে নিন বিকল্পে গিয়ে Cloud Run > Cloud Run Invoker বিকল্প বেছে নিন।

  7. সেভ করুন বিকল্পে ক্লিক করুন।

অ্যাড-অন নয় এমন Chat অ্যাপ কনফিগার করা

Cloud Run ফাংশন ডেপ্লয় করার পরে, এটিকে অ্যাড-অন নয় এমন চ্যাট অ্যাপে পরিণত করতে এইসব ধাপ অনুসরণ করুন:

  1. Google API কনসোলে, Cloud Run পৃষ্ঠায় যান:

    Cloud Run-এ যান

    আপনি যে প্রোজেক্টের জন্য Cloud Run চালু করেছেন সেটি বেছে নেওয়া হয়েছে কিনা ভাল করে দেখে নিন।

  2. পরিষেবার তালিকায়, quickstartchatapp-এ ক্লিক করুন।

  3. পরিষেবার বিবরণ পৃষ্ঠায়, ফাংশনের URL কপি করুন।

  4. "Google Chat API" খুঁজে Google Chat API বিকল্পে ক্লিক করুন, তারপর ম্যানেজ করুন বিকল্পে ক্লিক করুন।

    Chat API-তে যান

  5. কনফিগারেশন বিকল্পে ক্লিক করুন এবং এমন Chat অ্যাপ সেট-আপ করুন যেটি অ্যাড-অন নয়:

    1. এই চ্যাট অ্যাপকে Google Workspace অ্যাড-অন হিসেবে তৈরি করো বিকল্পটি বাতিল করো। আপনাকে কনফার্ম করতে বলে একটি ডায়ালগ খুলবে। ডায়ালগে, বন্ধ করুন বিকল্পে ক্লিক করুন।
    2. অ্যাপের নাম বিকল্পে Quickstart App লিখুন।
    3. অবতার URL-এ গিয়ে https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png লিখুন।
    4. বিবরণ বিভাগে, Quickstart app লিখুন।
    5. কার্যকারিতা বিকল্পের মধ্যে, স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।
    6. কানেকশন সেটিংস বিকল্পের মধ্যে, HTTP এন্ডপয়েন্ট URL বিকল্প বেছে নিন।
    7. ট্রিগার বিকল্পের মধ্যে, সব ট্রিগারের জন্য একটি সাধারণ HTTP এন্ডপয়েন্ট URL ব্যবহার করুন বিকল্প বেছে নিন এবং Cloud Run ফাংশন ট্রিগারের URLটি বক্সে পেস্ট করুন।
    8. দৃশ্যমানতা বিকল্পের অধীনে, আপনার ডোমেনে নির্দিষ্ট ব্যক্তি ও গ্রুপের জন্য এই Chat অ্যাপ উপলভ্য করুন বিকল্প বেছে নিন এবং আপনার ইমেল আইডি লিখুন।
    9. লগ বিকল্পের মধ্যে, লগিংয়ে লগ সংক্রান্ত সমস্যা বিকল্প বেছে নিন।
  6. সেভ করুন বিকল্পে ক্লিক করুন।