উন্নত চ্যাট পরিষেবা

অ্যাডভান্সড চ্যাট পরিষেবা আপনাকে অ্যাপস স্ক্রিপ্টে Google Chat API ব্যবহার করতে দেয়। এই API স্ক্রিপ্টগুলিকে চ্যাট স্পেসগুলি খুঁজে বের করতে, তৈরি করতে এবং সংশোধন করতে, স্পেসগুলিতে সদস্যদের যোগ বা সরাতে এবং পাঠ্য, কার্ড, সংযুক্তি এবং প্রতিক্রিয়া সহ বার্তাগুলি পড়তে বা পোস্ট করতে দেয়৷

পূর্বশর্ত

• Google ক্লাউড কনসোলে চ্যাট API কনফিগারেশন পৃষ্ঠায় কনফিগার করা একটি Apps Script Google Chat অ্যাপ। অ্যাপের অ্যাপস স্ক্রিপ্ট প্রোজেক্টকে অ্যাপস স্ক্রিপ্ট প্রোজেক্টের জন্য স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টের পরিবর্তে একটি স্ট্যান্ডার্ড Google ক্লাউড প্রজেক্ট ব্যবহার করতে হবে। একটি সামঞ্জস্যপূর্ণ Google Chat অ্যাপ তৈরি করতে, Apps Script দিয়ে Google Chat অ্যাপ তৈরি করুন দেখুন।
• চ্যাট অ্যাপের জন্য প্রমাণীকরণ কনফিগার করা হয়েছে। একজন ব্যবহারকারীর পক্ষ থেকে একটি ক্রিয়া সম্পাদন করার জন্য ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন। চ্যাট অ্যাপ্লিকেশান হিসাবে একটি কাজ সম্পাদন করার জন্য একটি পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ প্রমাণীকরণ প্রয়োজন৷ চ্যাট এপিআই পদ্ধতি কোন ধরনের প্রমাণীকরণ সমর্থন করে তা পরীক্ষা করতে, Google Chat API কলের জন্য প্রয়োজনীয় প্রমাণীকরণের প্রকার দেখুন।

দ্রষ্টব্য: এটি একটি উন্নত পরিষেবা যা ব্যবহারের আগে আপনাকে অবশ্যই চালু করতে হবে।

রেফারেন্স

এই পরিষেবা সম্পর্কে আরও তথ্যের জন্য, চ্যাট API রেফারেন্স ডকুমেন্টেশন দেখুন। অ্যাপস স্ক্রিপ্টের সমস্ত উন্নত পরিষেবাগুলির মতো, চ্যাট পরিষেবাটি পাবলিক API হিসাবে একই বস্তু, পদ্ধতি এবং পরামিতিগুলি ব্যবহার করে৷

নমুনা কোড

এই নমুনাগুলি আপনাকে দেখায় কিভাবে উন্নত পরিষেবা ব্যবহার করে সাধারণ Google Chat API অ্যাকশনগুলি সম্পাদন করতে হয়।

ব্যবহারকারীর শংসাপত্র সহ একটি বার্তা পোস্ট করুন

নিম্নলিখিত উদাহরণটি প্রদর্শন করে যে কীভাবে ব্যবহারকারীর পক্ষে একটি চ্যাট স্পেসে একটি বার্তা পোস্ট করতে হয়।

1. Apps Script প্রকল্পের appsscript.json ফাইলে chat.messages.create অনুমোদনের সুযোগ যোগ করুন:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.messages.create"
   ]
   

2. অ্যাপস স্ক্রিপ্ট প্রকল্পের কোডে এইরকম একটি ফাংশন যোগ করুন:

   উন্নত/chat.gs

   GitHub এ দেখুন
   /**
    * Posts a new message to the specified space on behalf of the user.
    * @param {string} spaceName The resource name of the space.
    */
   function postMessageWithUserCredentials(spaceName) {
     try {
       const message = {'text': 'Hello world!'};
       Chat.Spaces.Messages.create(message, spaceName);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to create message with error %s', err.message);
     }
   }

অ্যাপের শংসাপত্র সহ একটি বার্তা পোস্ট করুন

নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে অ্যাপের হয়ে চ্যাট স্পেসে একটি বার্তা পোস্ট করতে হয়। একটি পরিষেবা অ্যাকাউন্টের সাথে উন্নত চ্যাট পরিষেবা ব্যবহার করার জন্য আপনাকে appsscript.json এ অনুমোদনের সুযোগ নির্দিষ্ট করতে হবে না। পরিষেবা অ্যাকাউন্টগুলির সাথে প্রমাণীকরণ সম্পর্কে বিশদ বিবরণের জন্য, একটি Google চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ দেখুন৷

উন্নত/chat.gs

GitHub এ দেখুন

/**
 * Posts a new message to the specified space on behalf of the app.
 * @param {string} spaceName The resource name of the space.
 */
function postMessageWithAppCredentials(spaceName) {
  try {
    // See https://developers.google.com/chat/api/guides/auth/service-accounts
    // for details on how to obtain a service account OAuth token.
    const appToken = getToken_();
    const message = {'text': 'Hello world!'};
    Chat.Spaces.Messages.create(
        message,
        spaceName,
        {},
        // Authenticate with the service account token.
        {'Authorization': 'Bearer ' + appToken});
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed to create message with error %s', err.message);
  }
}

একটি স্থান পান

নিচের উদাহরণটি দেখায় কিভাবে একটি চ্যাট স্পেস সম্পর্কে তথ্য পেতে হয়।

1. Apps Script প্রকল্পের appsscript.json ফাইলে chat.spaces.readonly অনুমোদনের সুযোগ যোগ করুন:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.spaces.readonly"
   ]
   

2. অ্যাপস স্ক্রিপ্ট প্রকল্পের কোডে এইরকম একটি ফাংশন যোগ করুন:

   উন্নত/chat.gs

   GitHub এ দেখুন
   /**
    * Gets information about a Chat space.
    * @param {string} spaceName The resource name of the space.
    */
   function getSpace(spaceName) {
     try {
       const space = Chat.Spaces.get(spaceName);
       console.log('Space display name: %s', space.displayName);
       console.log('Space type: %s', space.spaceType);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to get space with error %s', err.message);
     }
   }

একটি স্থান তৈরি করুন

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি চ্যাট স্পেস তৈরি করতে হয়।

1. Apps Script প্রকল্পের appsscript.json ফাইলে chat.spaces.create অনুমোদনের সুযোগ যোগ করুন:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.spaces.create"
   ]
   

2. অ্যাপস স্ক্রিপ্ট প্রকল্পের কোডে এইরকম একটি ফাংশন যোগ করুন:

   উন্নত/chat.gs

   GitHub এ দেখুন
   /**
    * Creates a new Chat space.
    */
   function createSpace() {
     try {
       const space = {'displayName': 'New Space', 'spaceType': 'SPACE'};
       Chat.Spaces.create(space);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed to create space with error %s', err.message);
     }
   }

সদস্যপদ তালিকা

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি চ্যাট স্পেসের সমস্ত সদস্যকে তালিকাভুক্ত করতে হয়।

1. Apps Script প্রকল্পের appsscript.json ফাইলে chat.memberships.readonly অনুমোদনের সুযোগ যোগ করুন:

   "oauthScopes": [
     "https://www.googleapis.com/auth/chat.memberships.readonly"
   ]
   

2. অ্যাপস স্ক্রিপ্ট প্রকল্পের কোডে এইরকম একটি ফাংশন যোগ করুন:

   উন্নত/chat.gs

   GitHub এ দেখুন
   /**
    * Lists all the members of a Chat space.
    * @param {string} spaceName The resource name of the space.
    */
   function listMemberships(spaceName) {
     let response;
     let pageToken = null;
     try {
       do {
         response = Chat.Spaces.Members.list(spaceName, {
           pageSize: 10,
           pageToken: pageToken
         });
         if (!response.memberships || response.memberships.length === 0) {
           pageToken = response.nextPageToken;
           continue;
         }
         response.memberships.forEach((membership) => console.log(
             'Member resource name: %s (type: %s)',
             membership.name,
             membership.member.type));
         pageToken = response.nextPageToken;
       } while (pageToken);
     } catch (err) {
       // TODO (developer) - Handle exception
       console.log('Failed with error %s', err.message);
     }
   }

সমস্যা সমাধান

আপনি যদি Error 400: invalid_scope ত্রুটি বার্তার সম্মুখীন হন Some requested scopes cannot be shown , এর মানে আপনি Apps Script প্রকল্পের appsscript.json ফাইলে কোনো অনুমোদনের সুযোগ নির্দিষ্ট করেননি। বেশিরভাগ ক্ষেত্রে, অ্যাপস স্ক্রিপ্ট স্বয়ংক্রিয়ভাবে নির্ধারণ করে যে কোন স্ক্রিপ্টের কোন স্কোপের প্রয়োজন, কিন্তু আপনি যখন চ্যাট উন্নত পরিষেবা ব্যবহার করেন, তখন আপনাকে অবশ্যই ম্যানুয়ালি অনুমোদনের সুযোগ যোগ করতে হবে যা আপনার স্ক্রিপ্ট আপনার অ্যাপস স্ক্রিপ্ট প্রকল্পের ম্যানিফেস্ট ফাইলে ব্যবহার করে। সুস্পষ্ট স্কোপ সেট করা দেখুন।

ত্রুটিটি সমাধান করতে, oauthScopes অ্যারের অংশ হিসাবে Apps Script প্রকল্পের appsscript.json ফাইলে যথাযথ অনুমোদনের সুযোগ যোগ করুন। উদাহরণস্বরূপ, spaces.messages.create পদ্ধতিতে কল করতে, নিম্নলিখিত যোগ করুন:

"oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages.create"
]

সীমা এবং বিবেচনা

উন্নত চ্যাট পরিষেবা সমর্থন করে না:

• চ্যাট এপিআই পদ্ধতি media.download ।
• ডেভেলপার প্রিভিউতে Chat API পদ্ধতি উপলব্ধ

একটি বার্তা সংযুক্তি ডাউনলোড করতে বা একটি বিকাশকারী পূর্বরূপ পদ্ধতিতে কল করতে, পরিবর্তে UrlFetchApp ব্যবহার করুন৷