Google Chat অ্যাপকে Google Workspace অ্যাড-অনে কনভার্ট করা

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

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

সীমাবদ্ধতা

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

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

কনভার্সন প্রসেসের জন্য কোডে পরিবর্তন করতে হয়। আপনার লাইভ Google Chat অ্যাপকে প্রভাবিত হওয়া থেকে বাঁচাতে, আপনার কোডের একটি কপি তৈরি করুন এবং সেটিতে কাজ করুন।

Apps Script

  1. আপনার আগে থেকে থাকা Google Chat অ্যাপ Google Apps Script প্রজেক্ট খুলুন।
  2. স্ক্রিনের বাঁদিকে, এক নজরে বিকল্পে ক্লিক করুন।
  3. ডানদিকে, কপি তৈরি করুন বিকল্পে ক্লিক করুন।
  4. স্ক্রিনের বাঁদিকে, প্রোজেক্ট সেটিংস বিকল্পে ক্লিক করুন।
  5. Google Cloud প্রোজেক্ট বিকল্পের মধ্যে, প্রোজেক্ট পরিবর্তন করুন বিকল্পে ক্লিক করুন।
  6. আপনার আগে থেকে থাকা Google Chat অ্যাপ প্রোজেক্টের সাথে যুক্ত একই প্রোজেক্ট নম্বর লিখুন।
  7. প্রোজেক্ট সেট করুন বিকল্পে ক্লিক করুন।

HTTP

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

আপনার অ্যাপ Google Cloud-এ ডিপ্লয় করা হলে এবং Google Cloud প্রোজেক্টের সাথে যুক্ত ফিচারের উপর নির্ভর করলে (যেমন, ডিফল্ট App Engine পরিচয়), নতুন কোডটি আগে থেকে থাকা Google Chat অ্যাপ প্রোজেক্টের সাথে যুক্ত পরিষেবার উপর ডিপ্লয় করতে হবে।

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

Google Workspace অ্যাড-অন যা Google Chat-এর ব্যবহারকে প্রসারিত করে, তা অ্যাড-অন নয় এমন Chat অ্যাপের তুলনায় আলাদা আলাদা অনুরোধ ও উত্তর স্ট্রাকচার ব্যবহার করে। অনুরোধ ও উত্তরের জন্য আপনাকে Google Chat API ইন্টার‍্যাকশন ইভেন্টের (Event) পরিবর্তে Google Workspace অ্যাড-অন ইভেন্ট অবজেক্ট (EventObject) ব্যবহার করতে আপনার কোড আপডেট করতে হবে। আপনার কোড পরিবর্তন করতে কোড কনভার্সন গাইড ব্যবহার করুন।

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

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

  1. Google Cloud Console-এ Google Chat API কনফিগারেশন পৃষ্ঠায় যান।

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

  2. ইন্টার‍্যাক্টিভ ফিচার বিকল্পের মধ্যে, ইন্টার‍্যাক্টিভ ফিচার চালু করুন বিকল্প চালু করুন।

  3. Google Workspace অ্যাড-অনে কনভার্ট করুন বিকল্পের অধীনে, অ্যাড-অনে কনভার্ট করুন বিকল্পে ক্লিক করুন।

  4. অ্যাড-অন কনফিগারেশন সেটিংস চালু করুন বিকল্প চালু করুন।

  5. দৃশ্যমানতা বিভাগে, আপনার টেস্ট ব্যবহারকারীদের ইমেল আইডি যোগ করুন।

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

  7. সেভ করুন ও পরীক্ষা করুন বিকল্পে ক্লিক করুন।

ধাপ ৪: কনভার্ট করা অ্যাপ পরীক্ষা করুন

ধাপ ৩-এ কনফিগার করা টেস্ট ব্যবহারকারী অ্যাকাউন্ট ব্যবহার করে Google Workspace অ্যাড-অনের কার্যকারিতা ভালভাবে পরীক্ষা করুন। সব ফিচার ও ইন্টার‍্যাকশন যাচাই করুন।

ধাপ ৫: সব ব্যবহারকারীর জন্য কনভার্সন সম্পূর্ণ করুন

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

  1. Google Cloud Console-এ Google Chat API কনফিগারেশন পৃষ্ঠায় যান।

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

  2. ইন্টার‍্যাক্টিভ ফিচার বিকল্পের মধ্যে, অ্যাড-অন হিসেবে কনভার্ট করুন বিকল্পে ক্লিক করুন। একটি সাইড প্যানেল খুলে যায়।

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

  4. আপনার প্রোজেক্ট আইডি টাইপ করে পরিবর্তন করুন বিকল্পে ক্লিক করুন।

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

ঐচ্ছিক: অব্যবহৃত Google Cloud রিসোর্স ক্লিন-আপ বা ফ্রি করা

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

কোড কনভার্সন গাইড

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

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

নিচের সারণী থেকে বোঝা যায় যে, Google Chat API-এর Event কোনও অ্যাড-অন নয় এমন Chat অ্যাপের ফিল্ড, 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

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

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

ব্যবহারের ক্ষেত্র অ্যাড-অন নয় এমন চ্যাট অ্যাপ (Event পেলোড) Google Workspace অ্যাড-অন 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 অ্যাড-অন যা Google Chat-এর রিটার্ন অ্যাকশনকে এক্সটেন্ড করে, কোনও Message অবজেক্টের পরিবর্তে। নিম্নলিখিত সারণীটি Google Workspace অ্যাড-অন অ্যাকশনের সমতুল্য নয় এমন চ্যাট অ্যাপের জন্য Google Chat API Message উত্তরের ধরন ম্যাপ করে।

ব্যবহারের ক্ষেত্র অ্যাড-অন নয় এমন চ্যাট অ্যাপ (Message উত্তর) Google Workspace অ্যাড-অন Chat অ্যাকশন থেকে পাওয়া উত্তর
ইনভোক করা স্পেসে মেসেজ তৈরি করা 
{
  "actionResponse": {
    "type": "NEW_MESSAGE"
  },
  "text": "..."
}

actionResponse ঐচ্ছিক। আরও জানতে, স্ল্যাশ কমান্ডের উত্তর দিন দেখুন।

 
{
  "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": "..."
  }
}

আরও জানতে, অন্যান্য পরিষেবা ও টুলের সাথে Chat অ্যাপ কানেক্ট করা দেখুন।
ইন্টার‍্যাক্টিভ উইজেটে আইটেম অটো-কমপ্লিট করা 
{
  "actionResponse": {
    "type": "UPDATE_WIDGET",
    "updatedWidget": {
      "suggestions": {
        "items": ["..."]
      },
      "widget": "widget_id"
    }
  }
}

আরও জানতে, একাধিক বেছে নেওয়ার মেনু যোগ করুন দেখুন।

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

আরও জানতে, কার্ডে ব্যবহারকারীর ইনপুট করা ফর্ম ডেটা পড়া দেখুন।

কনভার্সনের আগে তৈরি করা মেসেজে কার্ড ইন্ট্যার‍্যাকশন ম্যানেজ করা

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

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

আরও জানতে, ইন্টার‍্যাক্টিভ ডায়ালগ খোলা দেখুন।



{
  "onClick": {
    "action": {
      "function": "submit"
    }
  }
}
 আপনি ঐচ্ছিকভাবে Google Cloud Console-এ ইভেন্ট-পিছু এন্ডপয়েন্ট কনফিগার করতে পারবেন, তবে এর মধ্যে কার্ড ক্লিক ইভেন্ট অন্তর্ভুক্ত থাকে না। কার্ড ইন্টার‍্যাকশন প্রয়োগ করার সময়, কার্ডের 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 ট্রিগারের জন্য সব ট্রিগারের জন্য সাধারণ HTTP এন্ডপয়েন্ট URL ব্যবহার করুন বিকল্প চালু করলে, বোতামে ক্লিক করা হয়েছে ইভেন্টের জন্যও সাধারণ URL ব্যবহার করা হয়।

Chat-এর কার্যকারিতা বাড়ায় এমন HTTP Google Workspace অ্যাড-অনের জন্য অনুরোধ যাচাই করা

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

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

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

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

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

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