একটি HTTP Google Chat অ্যাপ তৈরি করুন

Google API Console-এ, Cloud Run পৃষ্ঠায় যান:

ক্লাউড রানে যান

আপনার চ্যাট অ্যাপের জন্য প্রজেক্টটি নির্বাচন করা হয়েছে কিনা, তা নিশ্চিত করুন।

একটি ফাংশন লিখুন- এ ক্লিক করুন।

সার্ভিস তৈরি করুন পেজে, আপনার ফাংশনটি সেট আপ করুন:

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

সোর্স ট্যাবে:

1. এন্ট্রি পয়েন্টে , ডিফল্ট টেক্সটটি মুছে দিয়ে avatarApp লিখুন।

2. 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. সংরক্ষণ করুন এবং পুনরায় স্থাপন করুন ।

Google API Console-এ, Cloud Run পৃষ্ঠায় যান:

ক্লাউড রানে যান

আপনার চ্যাট অ্যাপের জন্য প্রজেক্টটি নির্বাচন করা হয়েছে কিনা, তা নিশ্চিত করুন।

একটি ফাংশন লিখুন- এ ক্লিক করুন।

সার্ভিস তৈরি করুন পেজে, আপনার ফাংশনটি সেট আপ করুন:

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

সোর্স ট্যাবে:

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. সংরক্ষণ করুন এবং পুনরায় স্থাপন করুন ।

Google API Console-এ, Cloud Run পৃষ্ঠায় যান:

ক্লাউড রানে যান

আপনার চ্যাট অ্যাপের জন্য প্রজেক্টটি নির্বাচন করা হয়েছে কিনা, তা নিশ্চিত করুন।

একটি ফাংশন লিখুন- এ ক্লিক করুন।

সার্ভিস তৈরি করুন পেজে, আপনার ফাংশনটি সেট আপ করুন:

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

সোর্স ট্যাবে:

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. সংরক্ষণ করুন এবং পুনরায় স্থাপন করুন ।