একটি ইন্টারেক্টিভ Google Chat অ্যাপকে Google Workspace অ্যাড-অনে রূপান্তর করুন

যদি আপনি এমন একটি Google Chat অ্যাপ তৈরি এবং প্রকাশ করে থাকেন যা Google Chat API ইন্টারঅ্যাকশন ইভেন্ট ব্যবহার করে, যেমন Google Chat অ্যাপ quickstart এর উপর ভিত্তি করে, তাহলে এই পৃষ্ঠাটি দেখায় কিভাবে এটিকে Google Workspace অ্যাড-অনে রূপান্তর করতে হয় যা Google Chat প্রসারিত করে।

রূপান্তরের মাধ্যমে, আপনার Google Chat অ্যাপ Google Workspace অ্যাড-অন ফ্রেমওয়ার্ক ব্যবহার করতে পারে, যা Google Chat এবং Google Workspace জুড়ে ইন্টিগ্রেশন এবং বৈশিষ্ট্যগুলির জন্য নতুন সম্ভাবনার দ্বার উন্মোচন করে। উদাহরণস্বরূপ, দুটি বিতরণের পরিবর্তে—একটি Google Chat অ্যাপ এবং একটি Google Workspace অ্যাড-অন—আপনি Google Workspace Marketplace এর মাধ্যমে একটি একক Google Workspace অ্যাড-অন বিতরণ করতে পারেন যা Gmail, Calendar এবং Docs এর মতো অন্যান্য Google Workspace হোস্ট অ্যাপ্লিকেশনের পাশাপাশি Chat অ্যাপগুলিকে প্রসারিত করে।

সীমাবদ্ধতা

রূপান্তর শুরু করার আগে, Google Workspace অ্যাড-অনগুলির সীমাবদ্ধতা পর্যালোচনা করুন যা Google Chat প্রসারিত করে যাতে আপনার Google Chat অ্যাপটি প্রয়োজনীয় কার্যকারিতা না হারিয়ে রূপান্তর করা যায়।

ধাপ ১: আপনার বিদ্যমান Google Chat অ্যাপ কোডটি কপি করুন

রূপান্তর প্রক্রিয়ার জন্য কোড পরিবর্তন প্রয়োজন। আপনার লাইভ Google Chat অ্যাপের উপর প্রভাব এড়াতে, আপনার কোডের একটি কপি তৈরি করুন এবং কাজ করুন।

অ্যাপস স্ক্রিপ্ট

  1. আপনার বিদ্যমান Google Chat অ্যাপ Google Apps Script প্রজেক্ট খুলুন।
  2. বাম দিকে, ওভারভিউ ক্লিক করুন।
  3. ডানদিকে, Make a copy এ ক্লিক করুন।
  4. বাম দিকে, Project Settings ক্লিক করুন।
  5. গুগল ক্লাউড প্রোজেক্টের অধীনে, প্রোজেক্ট পরিবর্তন করুন এ ক্লিক করুন।
  6. আপনার বিদ্যমান Google Chat অ্যাপ প্রোজেক্টের সাথে সম্পর্কিত একই প্রোজেক্ট নম্বরটি লিখুন।
  7. প্রজেক্ট সেট করুন এ ক্লিক করুন।

HTTP সম্পর্কে

আপনার বিদ্যমান কোডবেসের একটি ফর্ক বা কপি তৈরি করুন এবং এটিকে আপনার লাইভ গুগল চ্যাট অ্যাপ থেকে আলাদা করে একটি নতুন পরিষেবা হিসেবে স্থাপন করুন।

যদি আপনার অ্যাপটি গুগল ক্লাউডে স্থাপন করা হয় এবং গুগল ক্লাউড প্রকল্পের সাথে সম্পর্কিত বৈশিষ্ট্যগুলির উপর নির্ভর করে (উদাহরণস্বরূপ, ডিফল্ট অ্যাপ ইঞ্জিন পরিচয়), তাহলে নতুন কোডটি বিদ্যমান গুগল চ্যাট অ্যাপ প্রকল্পের সাথে সম্পর্কিত একটি পরিষেবাতে স্থাপন করা উচিত।

ধাপ ২: কপি করা কোডটি পরিবর্তন করুন

Google Workspace অ্যাড-অনগুলি যা Google Chat-কে প্রসারিত করে, Chat API ইন্টারঅ্যাকশন ইভেন্ট দিয়ে তৈরি Google Chat অ্যাপগুলির তুলনায় ভিন্ন অনুরোধ এবং প্রতিক্রিয়া কাঠামো ব্যবহার করে। অনুরোধ এবং প্রতিক্রিয়ার জন্য Google Chat API-এর Event পরিবর্তে Google Workspace অ্যাড-অন EventObject ব্যবহার করার জন্য আপনাকে আপনার কোড আপডেট করতে হবে। আপনার কোড পরিবর্তন করতে কোড রূপান্তর নির্দেশিকা ব্যবহার করুন।

ধাপ ৩: পরীক্ষামূলক ব্যবহারকারীদের জন্য Google Workspace অ্যাড-অন কনফিগারেশন সক্ষম করুন

আপনার Google Chat অ্যাপের জন্য Google Workspace অ্যাড-অন সেটিংস কনফিগার করতে Google Cloud কনসোল ব্যবহার করুন:

  1. গুগল ক্লাউড কনসোলে গুগল চ্যাট এপিআই কনফিগারেশন পৃষ্ঠায় যান।

    Google Chat API কনফিগারেশন পৃষ্ঠায় যান

  2. ইন্টারেক্টিভ বৈশিষ্ট্যগুলির অধীনে, অ্যাড-অনে রূপান্তর করুন ক্লিক করুন।

  3. অ্যাড-অন কনফিগারেশন সেটিংস চালু করুন সক্ষম করুন।

  4. দৃশ্যমানতা বিভাগে, আপনার পরীক্ষামূলক ব্যবহারকারীদের ইমেল ঠিকানা যোগ করুন।

  5. প্রয়োজনে, ধাপ ২ থেকে আপনার কপি করা এবং পরিবর্তিত Google Chat অ্যাপ কোডের ডিপ্লয়মেন্ট এন্ডপয়েন্ট URL অথবা Apps Script ডিপ্লয়মেন্ট আইডি দিয়ে কানেকশন সেটিংস আপডেট করুন।

  6. সংরক্ষণ করুন এবং পরীক্ষা করুন ক্লিক করুন।

ধাপ ৪: রূপান্তরিত অ্যাপটি পরীক্ষা করুন

ধাপ ৩-এ কনফিগার করা টেস্ট ইউজার অ্যাকাউন্ট ব্যবহার করে Google Workspace অ্যাড-অন কার্যকারিতা পুঙ্খানুপুঙ্খভাবে পরীক্ষা করুন। সমস্ত বৈশিষ্ট্য এবং ইন্টারঅ্যাকশন যাচাই করুন।

ধাপ ৫: সকল ব্যবহারকারীর জন্য রূপান্তরটি সম্পূর্ণ করুন

রূপান্তরিত Google Workspace অ্যাড-অন সঠিকভাবে কাজ করছে কিনা তা যাচাই করার পরে, আপনি এটি সমস্ত ব্যবহারকারীর জন্য উপলব্ধ করতে পারেন।

  1. গুগল ক্লাউড কনসোলে গুগল চ্যাট এপিআই কনফিগারেশন পৃষ্ঠায় যান।

    Google Chat API কনফিগারেশন পৃষ্ঠায় যান

  2. ইন্টারেক্টিভ বৈশিষ্ট্যগুলির অধীনে, অ্যাড-অনে রূপান্তর করুন ক্লিক করুন। একটি পার্শ্ব প্যানেল খোলে।

  3. পাশের প্যানেলে, কনভার্ট টু অ্যাড-অন এ ক্লিক করুন।

  4. আপনার প্রজেক্ট আইডি টাইপ করুন এবং Convert এ ক্লিক করুন।

আপনার Google Chat অ্যাপটি এখন একটি Google Workspace অ্যাড-অন যা Google Chat-এর পরিষেবা প্রসারিত করে।

ঐচ্ছিক: অব্যবহৃত Google ক্লাউড রিসোর্স পরিষ্কার করুন বা মুক্ত করুন

ঐচ্ছিকভাবে, আপনার Google Chat অ্যাপটিকে Google Workspace অ্যাড-অনে রূপান্তর করার পরে, Google Chat অ্যাপের ব্যবহৃত রিসোর্সগুলির জন্য আপনার Google Cloud অ্যাকাউন্টে চার্জ এড়াতে, যা আর ব্যবহার করা হচ্ছে না, সেগুলি বন্ধ করার কথা বিবেচনা করুন।

কোড রূপান্তর নির্দেশিকা

এই বিভাগে Google Chat API ইন্টারঅ্যাকশন Event ফর্ম্যাট এবং Google Workspace অ্যাড-অন EventObject ফর্ম্যাটের মধ্যে ম্যাপিংয়ের বিশদ বিবরণ দেওয়া হয়েছে।

ম্যাপিংয়ের অনুরোধ করুন

নিম্নলিখিত টেবিলটি দেখায় যে কীভাবে Google Chat API Event এর ক্ষেত্রগুলি Google Workspace অ্যাড-অন EventObject এর সংশ্লিষ্ট ক্ষেত্রগুলির সাথে ম্যাপ করে।

গুগল চ্যাট এপিআই ইন্টারঅ্যাকশন Event ফিল্ড Google Workspace অ্যাড-অন EventObject ফিল্ড মন্তব্য
action.actionMethodName নিষিদ্ধ কার্ড ইন্টারঅ্যাকশনের জন্য, পদ্ধতির নামটি commonEventObject.parameters এ একটি প্যারামিটার হিসেবে পাস করা যেতে পারে। একটি প্রাথমিক ডায়ালগ খুলুন দেখুন।
action.parameters commonEventObject.parameters
appCommandMetadata chat.appCommandPayload.appCommandMetadata
common commonEventObject
configCompleteRedirectUrl
  • chat.appCommandPayload.configCompleteRedirectUri
  • chat.addedToSpacePayload.configCompleteRedirectUri
  • chat.messagePayload.configCompleteRedirectUri
 ইভেন্টের ধরণের উপর নির্ভর করে বিভিন্ন পেলোডে উপলব্ধ।
dialogEventType
  • chat.appCommandPayload.dialogEventType
  • chat.buttonClickedPayload.dialogEventType
 ইভেন্টের ধরণের উপর নির্ভর করে বিভিন্ন পেলোডে উপলব্ধ।
eventTime chat.eventTime
isDialogEvent
  • chat.appCommandPayload.isDialogEvent
  • chat.buttonClickedPayload.isDialogEvent
 ইভেন্টের ধরণের উপর নির্ভর করে বিভিন্ন পেলোডে উপলব্ধ।
message
  • chat.messagePayload.message
  • chat.buttonClickedPayload.message
  • chat.appCommandPayload.message
 ইভেন্টের ধরণের উপর নির্ভর করে বিভিন্ন পেলোডে উপলব্ধ।
space
  • chat.messagePayload.space
  • chat.addedToSpacePayload.space
  • chat.removedFromSpacePayload.space
  • chat.buttonClickedPayload.space
  • chat.widgetUpdatedPayload.space
  • chat.appCommandPayload.space
thread
  • chat.messagePayload.message.thread
  • chat.buttonClickedPayload.message.thread
  • chat.appCommandPayload.message.thread
 ইভেন্টের ধরণের উপর নির্ভর করে বিভিন্ন পেলোডে উপলব্ধ।
threadKey
  • chat.messagePayload.message.thread.threadKey
  • chat.buttonClickedPayload.message.thread.threadKey
  • chat.appCommandPayload.message.threadKey
 ইভেন্টের ধরণের উপর নির্ভর করে বিভিন্ন পেলোডে উপলব্ধ।
token নিষিদ্ধ যাচাইকরণ ভিন্নভাবে পরিচালিত হয়, HTTP অ্যাপের জন্য অনুরোধ যাচাইকরণ দেখুন।
type নিষিদ্ধ ট্রিগার থেকে ইভেন্টের ধরণ বের করা যেতে পারে।
user chat.user

ব্যবহারের ধরণ অনুসারে ম্যাপিংয়ের অনুরোধ করুন

নিম্নলিখিত টেবিলে Chat API ইন্টারঅ্যাকশন ইভেন্ট দিয়ে তৈরি Google Chat অ্যাপ এবং Google Chat প্রসারিত করে এমন Google Workspace অ্যাড-অনের মধ্যে সাধারণ ব্যবহারের ক্ষেত্রে অনুরোধ পেলোডের পার্থক্য দেখানো হয়েছে।

ব্যবহারের ধরণ চ্যাট API ইন্টারঅ্যাকশন Event পেলোড গুগল ওয়ার্কস্পেস অ্যাড-অন EventObject পেলোড
অ্যাপটি স্পেসে যোগ করা হয়েছে 
{
  "type": "ADDED_TO_SPACE",
  "space": { ... }
}
{
  "chat": {
    "addedToSpacePayload": {
      "space": { ... }
    }
  }
}
স্পেস থেকে অ্যাপটি সরান 
{
  "type": "REMOVED_FROM_SPACE",
  "space": { ... }
}
{
  "chat": {
    "removedFromSpacePayload": {
      "space": { ... }
    }
  }
}
ব্যবহারকারী @-একটি অ্যাপের উল্লেখ করেন 
{
  "type": "MESSAGE",
  "message": { ... },
  "space": { ... },
  "configCompleteRedirectUrl": "..."
}
{
  "chat": {
    "messagePayload": {
      "message": { ... },
      "space": { ... },
      "configCompleteRedirectUri": "..."
    }
  }
}
ব্যবহারকারী @-স্পেসে একটি অ্যাপ যোগ করার জন্য এটি উল্লেখ করেন আপনাকে Google Chat থেকে একটি অনুরোধ পরিচালনা করতে হবে:
{
  "type": "ADDED_TO_SPACE",
  "space": { ... },
  "message": { ... }
}
আপনাকে Google Chat থেকে দুটি অনুরোধ পরিচালনা করতে হবে।

প্রথম অনুরোধ:
{
  "chat": {
    "addedToSpacePayload": {
      "space": { ... },
      "interactionAdd": true
    }
  }
}

দ্বিতীয় অনুরোধ:
{
  "chat": {
    "messagePayload": {
      "message": { ... },
      "space": { ... }
    }
  }
}
স্ল্যাশ কমান্ড 
{
  "type": "MESSAGE",
  "message": { "slashCommand": { ... } },
  "space": { ... }
}
{
  "chat": {
    "appCommandPayload": {
      "message": { ... },
      "space": { ... },
      "appCommandMetadata": { ... }
    }
  }
}
স্পেসে একটি অ্যাপ যোগ করার জন্য স্ল্যাশ কমান্ড আপনাকে Google Chat থেকে একটি অনুরোধ পরিচালনা করতে হবে: 
{
  "type": "ADDED_TO_SPACE",
  "space": { ... },
  "message": { "slashCommand": { ... } }
}
 আপনাকে Google Chat থেকে দুটি অনুরোধ পরিচালনা করতে হবে।

প্রথম অনুরোধ: 
{
  "chat": {
    "addedToSpacePayload": {
      "space": { ... },
      "interactionAdd": true
    }
  }
}

দ্বিতীয় অনুরোধ: 
{
  "chat": {
    "appCommandPayload": {
      "message": { ... },
      "space": { ... },
      "appCommandMetadata": { ... }
    }
  }
}
ব্যবহারকারী একটি কার্ড বা ডায়ালগের একটি বোতামে ক্লিক করেন 
{
  "type": "CARD_CLICKED",
  "common": { ... },
  "space": { ... },
  "message": { ... },
  "isDialogEvent": "...",
  "dialogEventType": "..."
}

ডায়ালগ ইভেন্টের জন্য, common.formInputs উইজেটের মান থাকে। Google Apps স্ক্রিপ্টের উদাহরণ: 

{
  "type": "CARD_CLICKED",
  "common": {
   "formInputs": {
    "contactName": {
      "": { "stringInputs": { "value": ["Kai 0"] }}
    }
  }
  },
  "space": { ... },
  "message": { ... },
  "isDialogEvent": true,
  "dialogEventType": "..."
}
{
  "commonEventObject": { ... },
  "chat": {
    "buttonClickedPayload": {
      "message": { ... },
      "space": { ... },
      "isDialogEvent": "...",
      "dialogEventType": "..."
    }
  }
}

ডায়ালগ ইভেন্টের জন্য, commonEventObject.formInputs উইজেটের মান থাকে। Google Apps স্ক্রিপ্টের উদাহরণ: 

{
  "commonEventObject": {
     "formInputs": {
      "contactName": {
        "stringInputs": {
          "value": ["Kai 0"]
        }
      }
    }
  },
  "chat": {
    "buttonClickedPayload": {
      "message": { ... },
      "space": { ... },
      "isDialogEvent": "true",
      "dialogEventType": "..."
    }
  }
}
ব্যবহারকারী একটি অ্যাপ হোম কার্ডে তথ্য জমা দেন 
{
  "type": "SUBMIT_FORM",
  "common": { ... },
  "space": { ... },
  "message": { ... },
  "isDialogEvent": "...",
  "dialogEventType": "..."
}
{
  "commonEventObject": { ... },
  "chat": {
    "buttonClickedPayload": {
      "message": { ... },
      "space": { ... },
      "isDialogEvent": "...",
      "dialogEventType": "SUBMIT_DIALOG"
    }
  }
}
ব্যবহারকারী একটি দ্রুত কমান্ড ব্যবহার করে একটি অ্যাপ কমান্ড আহ্বান করে। 
{
  "type": "APP_COMMAND",
  "space": { ... },
  "isDialogEvent": "...",
  "dialogEventType": "..."
}
{
  "chat": {
    "appCommandPayload": {
      "message": { ... },
      "space": { ... },
      "appCommandMetadata": { ... }
    }
  }
}
লিঙ্ক প্রিভিউ 
{
  "type": "MESSAGE",
  "message": {
    "matchedUrl": "..."
  },
  "space": { ... }
}
{
  "chat": {
    "messagePayload": {
      "message": {
        "matchedUrl": "..."
      },
      "space": { ... }
    }
  }
}
ব্যবহারকারী একটি কার্ড বার্তা বা ডায়ালগে একটি উইজেট আপডেট করে 
{
  "type": "WIDGET_UPDATED",
  "space": { ... },
  "common": { ... }
}
{
  "commonEventObject": { ... },
  "chat": {
    "widgetUpdatedPayload": {
      "space": { ... }
    }
  }
}

ব্যবহারের ধরণ অনুসারে প্রতিক্রিয়া ম্যাপিং

Google Workspace অ্যাড-অনগুলি যা Message অবজেক্টের পরিবর্তে Google Chat রিটার্ন অ্যাকশনগুলিকে প্রসারিত করে। নিম্নলিখিত টেবিলটি Google Chat API Message প্রতিক্রিয়ার ধরণগুলিকে তাদের Google Workspace অ্যাড-অন অ্যাকশন সমতুল্যের সাথে ম্যাপ করে।

ব্যবহারের ধরণ গুগল চ্যাট এপিআই Message রেসপন্স Google Workspace অ্যাড-অন চ্যাট অ্যাকশন রেসপন্স
আমন্ত্রিত স্থানে একটি বার্তা তৈরি করুন 
{
  "actionResponse": {
    "type": "NEW_MESSAGE"
  },
  "text": "..."
}

actionResponse ঐচ্ছিক। আরও জানতে, "Responde to a slash" কমান্ডটি দেখুন। 

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "text": "..."
         }
       }
    }
  }
}

আরও জানতে, একটি বার্তা পাঠান দেখুন।

একটি বার্তা আপডেট করুন 
{
 "actionResponse": {
  "type": "UPDATE_MESSAGE"
  },
 "text": "..."
}

আরও জানতে, একটি বার্তা আপডেট করুন (চ্যাট) দেখুন। 

{
  "hostAppDataAction": {
    "chatDataAction": {
      "updateMessageAction": {
        "message": {
          "text": "..."
         }
       }
    }
  }
}

আরও জানতে, একটি বার্তা আপডেট করুন (অ্যাড-অন) দেখুন।

লিঙ্ক প্রিভিউ 
{
  "actionResponse": {
    "type": "UPDATE_USER_MESSAGE_CARDS"
  },
  "cardsV2": [{ ... }]
}

আরও জানতে, একটি লিঙ্কের পূর্বরূপ দেখুন (চ্যাট) । 

{
  "hostAppDataAction": {
    "chatDataAction": {
      "updateInlinePreviewAction": {
        "cardsV2": [{ ... }]
      }
    }
  }
}

আরও জানতে, একটি লিঙ্কের পূর্বরূপ দেখুন (অ্যাড-অন) ।

একটি প্রাথমিক ডায়ালগ খুলুন 
{
  "actionResponse": {
    "type": "DIALOG",
    "dialogAction": {
      "dialog": {
        "body": { /* Card object */ }
      }
    }
  }
}

আরও জানতে, একটি ডায়ালগ খুলুন (চ্যাট) দেখুন। 

{
  "action": {
    "navigations": [{
      "pushCard": { /* Card object */ }
     }]
   }
}

আপনার পুশ করা কার্ডে onClick অ্যাকশন সহ উইজেট থাকতে পারে। HTTP Google Workspace অ্যাড-অনের জন্য, একটি ফাংশন এন্ডপয়েন্ট কল করার জন্য এই অ্যাকশনগুলি কনফিগার করুন:
{
  "onClick": {
    "action": {
      "function": "https://...",
      "parameters": [{
        "key": "clickedButton",
        "value": "submit"
      }]
    }
  }
}

আরও জানতে, একটি ডায়ালগ খুলুন (অ্যাড-অন) দেখুন।

একটি ডায়ালগ বন্ধ করুন 
{
  "actionResponse": {
    "type": "DIALOG",
    "dialogAction": {
      "actionStatus": {
        "userFacingMessage": "..."
      }
    }
  }
}

আরও জানতে, একটি ডায়ালগ বন্ধ করুন (চ্যাট) দেখুন। 

{
  "action": {
    "navigations": [{
      "endNavigation": "CLOSE_DIALOG"
    }],
    "notification": { "text": "..."}
  }
}

আরও জানতে, একটি ডায়ালগ বন্ধ করুন (অ্যাড-অন) দেখুন।

একটি বহিরাগত সিস্টেমের সাথে সংযোগ করুন (কনফিগারেশনের অনুরোধ করুন) 
{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "..."
  }
}

আরও জানতে, একটি বহিরাগত সিস্টেমের সাথে সংযোগ করুন দেখুন। 

{
  "basic_authorization_prompt": {
    "authorization_url": "...",
    "resource": "..."
  }
}

আরও জানতে, আপনার Google Workspace অ্যাড-অনটিকে একটি তৃতীয় পক্ষের পরিষেবার সাথে সংযুক্ত করুন দেখুন।

ইন্টারেক্টিভ উইজেটে স্বয়ংক্রিয়ভাবে আইটেমগুলি পূরণ করুন 
{
  "actionResponse": {
    "type": "UPDATE_WIDGET",
    "updatedWidget": {
      "suggestions": {
        "items": ["..."]
      },
      "widget": "widget_id"
    }
  }
}

আরও জানতে, একটি মাল্টিসিলেক্ট মেনু যোগ করুন দেখুন। 

{
  "action": {
    "modifyOperations": [{
      "updateWidget": {
        "widgetId": "widget_id",
        "selectionInputWidgetSuggestions": {
          "suggestions": ["..."]
        }
      }
    }]
  }
}

আরও জানতে, Google Chat ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ এবং প্রক্রিয়াকরণ দেখুন।

রূপান্তরের আগে তৈরি বার্তাগুলিতে কার্ড ইন্টারঅ্যাকশন পরিচালনা করুন

যখন আপনি একটি HTTP Google Chat অ্যাপকে Google Workspace অ্যাড-অনে রূপান্তর করেন, তখন রূপান্তরের আগে তৈরি বার্তাগুলিতে কার্ড ইন্টারঅ্যাকশনের জন্য বিশেষ হ্যান্ডলিং প্রয়োজন হয়। Google Workspace অ্যাড-অনগুলি একটি কার্ডের action.function এর জন্য একটি সম্পূর্ণ HTTP URL ব্যবহার করে, যেখানে Google Chat API ইন্টারঅ্যাকশন ইভেন্ট দিয়ে তৈরি Google Chat অ্যাপগুলি একটি ফাংশনের নাম ব্যবহার করে। নিম্নলিখিত সারণীতে এই পার্থক্যগুলি সংক্ষিপ্ত করা হয়েছে।

গুগল চ্যাট অ্যাপটি গুগল চ্যাট এপিআই ইন্টারঅ্যাকশন ইভেন্ট দিয়ে তৈরি। Google Workspace অ্যাড-অন যা Google Chat-এর পরিধি বাড়ায়
কনফিগারেশন গুগল ক্লাউড কনসোলে সমস্ত ইভেন্টের জন্য আপনি একটি একক এন্ডপয়েন্ট কনফিগার করেন। কার্ড ইন্টারঅ্যাকশন বাস্তবায়নের সময়, একটি কার্ডের action শুধুমাত্র কার্যকর করার জন্য ফাংশনের নাম থাকে। কার্ড ক্লিক ইভেন্টের জন্য সাধারণ HTTP এন্ডপয়েন্টটি আহ্বান করা হয়।

আরও জানতে, একটি ডায়ালগ খুলুন (চ্যাট) দেখুন। 



{
  "onClick": {
    "action": {
      "function": "submit"
    }
  }
}
 আপনি ঐচ্ছিকভাবে Google ক্লাউড কনসোলে প্রতি-ইভেন্ট এন্ডপয়েন্ট কনফিগার করতে পারেন, তবে এতে কার্ড ক্লিক ইভেন্ট অন্তর্ভুক্ত নয়। কার্ড ইন্টারঅ্যাকশন বাস্তবায়নের সময়, একটি কার্ডের action অবশ্যই HTTP এন্ডপয়েন্টের সম্পূর্ণ URL থাকতে হবে যা ইনভোক করা হবে। আপনি প্রতি বোতামে একটি অনন্য HTTP এন্ডপয়েন্ট সেট করতে পারেন, অথবা একটি সাধারণ এন্ডপয়েন্ট ব্যবহার করতে পারেন এবং action.parameters এ একটি প্যারামিটার হিসাবে অ্যাকশনটি পাস করতে পারেন।

আরও জানতে, একটি ডায়ালগ খুলুন (অ্যাড-অন) দেখুন। 



{
  "onClick": {
    "action": {
      "function": "https://...",
      "parameters": [{
        "key": "method",
        "value": "submit"
      }]
    }
  }
}

রূপান্তরের আগে তৈরি করা বার্তাগুলির জন্য কার্ড ইন্টারঅ্যাকশনগুলি কার্যকরী কিনা তা নিশ্চিত করতে, Google Chat API কনফিগারেশন পৃষ্ঠায় একটি কার্ড ইন্টারঅ্যাকশন URL কনফিগার করুন।

এই URL টি শুধুমাত্র আপনার অ্যাপ রূপান্তর করার আগে তৈরি করা বার্তাগুলির সাথে ইন্টারঅ্যাকশনের জন্য ব্যবহৃত হয়। যখন কোনও ব্যবহারকারী এই বার্তাগুলির একটির সাথে ইন্টারঅ্যাক্ট করে, তখন মূল action.function মানটি __action_method_name__ নামক একটি প্যারামিটার হিসাবে পাস করা হয়।

উদাহরণ: কার্ড ক্লিক

যদি আপনি কার্ড ইন্টারঅ্যাকশন URL টি https://.../card-interaction-handler হিসাবে কনফিগার করেন, এবং একজন ব্যবহারকারী নিম্নলিখিত ক্রিয়া সহ একটি ঐতিহাসিক বার্তায় একটি কার্ডে ক্লিক করেন: 

{
  "onClick": {
    "action": {
     "function": "submit"
    }
  }
}

আপনার কনফিগার করা কার্ড ইন্টারঅ্যাকশন URL- এ নিম্নলিখিত ফর্ম্যাট সহ একটি ইভেন্ট সরবরাহ করা হয়: 

{
  "commonEventObject": {
    "parameters": {
      "__action_method_name__": "submit"
    }
  },
  "chat": {
    "buttonClickedPayload": { ... }
  }
}

উদাহরণ: মাল্টি-সিলেক্ট মেনু

যদি কোনও ব্যবহারকারী একটি বহিরাগত ডেটা উৎসের সাথে একাধিক-নির্বাচন মেনু ব্যবহার করে: 

{
  "selectionInput": {
    "name": "contacts",
    "type": "MULTI_SELECT",
    "externalDataSource": {
      "function": "getContacts"
    }
  }
}

আপনার কনফিগার করা কার্ড ইন্টারঅ্যাকশন URL- এ নিম্নলিখিত ফর্ম্যাট সহ একটি ইভেন্ট সরবরাহ করা হয়: 

{
  "commonEventObject": {
    "parameters": {
      "__action_method_name__": "getContacts",
    }
  },
  "chat": {
    "widgetUpdatedPayload": { ... }
  }
}

যদি আপনি আপনার HTTP ট্রিগারের জন্য "Use common HTTP endpoint url for all trigger" চালু করেন, তাহলে বোতাম ক্লিক করা ইভেন্টের জন্যও সাধারণ URL ব্যবহার করা হবে।

Chat এক্সটেন্ড করে এমন HTTP Google Workspace অ্যাড-অনের অনুরোধ যাচাই করুন

HTTP-ভিত্তিক Google Chat অ্যাপের ক্ষেত্রে, Google Workspace অ্যাড-অনে রূপান্তর করার সময় অনুরোধগুলি Google থেকে এসেছে কিনা তা যাচাই করার যুক্তি আপডেট করতে হবে।

অনুরোধ যাচাইকরণের মূল পার্থক্যগুলি হল:

অ্যাপের ধরণ সমর্থিত শ্রোতা পরিষেবা অ্যাকাউন্টের ইমেল
গুগল চ্যাট অ্যাপটি গুগল চ্যাট এপিআই ইন্টারঅ্যাকশন ইভেন্ট দিয়ে তৈরি। প্রকল্প নম্বর chat@system.gserviceaccount.com
Google Workspace অ্যাড-অন Google Chat-এর প্রসার ঘটাচ্ছে শুধুমাত্র HTTP এন্ডপয়েন্ট প্রতি-প্রজেক্ট পরিষেবা অ্যাকাউন্টের ইমেল

আপনার Google Workspace অ্যাড-অনের জন্য অনন্য পরিষেবা অ্যাকাউন্টের ইমেলটি Google Cloud কনসোলের Google Chat API কনফিগারেশন পৃষ্ঠার "Convert to Google Workspace অ্যাড-অন" বিভাগে পাওয়া যাবে।

আপনার আপগ্রেড করা Google Workspace অ্যাড-অনে অনুরোধ যাচাই করতে:

  1. যদি ক্লাউড রান ফাংশন ব্যবহার করেন, তাহলে প্রতি-অ্যাডন পরিষেবা অ্যাকাউন্টে roles/cloudfunctions.invoker ভূমিকাটি প্রদান করুন। IAM এর মাধ্যমে অ্যাক্সেস অনুমোদন করুন দেখুন।
  2. Bearer টোকেনের স্বাক্ষর যাচাই করার জন্য Google Workspace অ্যাড-অন পরিষেবা অ্যাকাউন্ট ইমেল ব্যবহার করতে আপনার টোকেন যাচাইকরণ কোড আপডেট করুন। Google থেকে অনুরোধ যাচাই করুন দেখুন।