Google Apps স্ক্রিপ্ট দ্রুত শুরু

একটি গুগল অ্যাপস স্ক্রিপ্ট তৈরি করুন যা গুগল চ্যাট এপিআই-তে অনুরোধ পাঠাবে।

কুইকস্টার্টস ব্যাখ্যা করে কিভাবে একটি অ্যাপ সেট আপ এবং রান করতে হয় যা একটি গুগল ওয়ার্কস্পেস এপিআই কল করে। এই কুইকস্টার্টটি একটি সরলীকৃত অথেনটিকেশন পদ্ধতি ব্যবহার করে যা একটি টেস্টিং এনভায়রনমেন্টের জন্য উপযুক্ত। একটি প্রোডাকশন এনভায়রনমেন্টের জন্য, আমরা আপনার অ্যাপের জন্য উপযুক্ত অ্যাক্সেস ক্রেডেনশিয়াল বেছে নেওয়ার আগে অথেনটিকেশন এবং অথরাইজেশন সম্পর্কে জেনে নেওয়ার পরামর্শ দিই।

অ্যাপস স্ক্রিপ্টে, গুগল ওয়ার্কস্পেস কুইকস্টার্টগুলো গুগল ওয়ার্কস্পেস এপিআই কল করতে এবং অথেনটিকেশন ও অথরাইজেশন ফ্লো-এর কিছু খুঁটিনাটি বিষয় পরিচালনা করতে অ্যাডভান্সড গুগল সার্ভিস ব্যবহার করে।

উদ্দেশ্য

• পরিবেশটি কনফিগার করুন।
• স্ক্রিপ্টটি তৈরি ও কনফিগার করুন।
• স্ক্রিপ্টটি চালান।

পূর্বশর্ত

• একটি গুগল ক্লাউড প্রকল্প ।

• গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি ব্যবসায়িক বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট।

আপনার ক্লাউড প্রজেক্ট কনফিগার করুন

আপনি যদি এই কুইকস্টার্টটি সম্পন্ন করার জন্য একটি নতুন গুগল ক্লাউড প্রজেক্ট ব্যবহার করেন, তাহলে আপনাকে এটি কনফিগার করতে হবে এবং নিজেকে একজন টেস্ট ইউজার হিসেবে যুক্ত করতে হবে। আপনি যদি আপনার ক্লাউড প্রজেক্টের জন্য এই ধাপগুলো ইতিমধ্যেই সম্পন্ন করে থাকেন, তাহলে পরবর্তী বিভাগে চলে যান।

গুগল ক্লাউড কনসোলে আপনার ক্লাউড প্রজেক্টটি খুলুন।

যদি আগে থেকে খোলা না থাকে, তাহলে এই স্যাম্পলটির জন্য আপনি যে ক্লাউড প্রজেক্টটি ব্যবহার করতে চান সেটি খুলুন:

1. গুগল ক্লাউড কনসোলে, 'Select a project' পেজে যান।

   একটি ক্লাউড প্রকল্প নির্বাচন করুন

2. আপনি যে গুগল ক্লাউড প্রজেক্টটি ব্যবহার করতে চান, সেটি নির্বাচন করুন। অথবা, 'Create project'-এ ক্লিক করুন এবং স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনি যদি একটি গুগল ক্লাউড প্রজেক্ট তৈরি করেন, তাহলে প্রজেক্টটির জন্য বিলিং চালু করার প্রয়োজন হতে পারে।

চ্যাট এপিআই চালু করুন

• গুগল ক্লাউড কনসোলে গুগল চ্যাট এপিআই (Google Chat API) সক্রিয় করুন।

  এপিআই সক্রিয় করুন

OAuth সম্মতি স্ক্রিন কনফিগার করুন

1. Google API কনসোলে, menu > Google Auth প্ল্যাটফর্ম > ব্র্যান্ডিং- এ যান।

   ব্র্যান্ডিং-এ যান

2. আপনি যদি ইতিমধ্যেই Google Auth প্ল্যাটফর্মটি কনফিগার করে থাকেন, তাহলে আপনি Branding , Audience , এবং Data Access- এ নিম্নলিখিত OAuth Consent Screen সেটিংস কনফিগার করতে পারেন। যদি আপনি এমন কোনো বার্তা দেখতে পান যেখানে লেখা আছে ‘Google Auth প্ল্যাটফর্ম এখনও কনফিগার করা হয়নি’ , তাহলে Get Started-এ ক্লিক করুন:
1. 'অ্যাপ ইনফরমেশন'- এর অধীনে 'অ্যাপ নেম' -এ অ্যাপটির জন্য একটি নাম লিখুন।
2. ব্যবহারকারী সহায়তা ইমেল- এ, এমন একটি সহায়তা ইমেল ঠিকানা বেছে নিন যেখানে ব্যবহারকারীরা তাদের সম্মতি সম্পর্কে কোনো প্রশ্ন থাকলে আপনার সাথে যোগাযোগ করতে পারে।
3. পরবর্তী ধাপে যান।
4. Audience-এর অধীনে Internal নির্বাচন করুন।
5. পরবর্তী ধাপে যান।
6. যোগাযোগের তথ্যের অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে জানানো যাবে।
7. পরবর্তী ধাপে যান।
8. Finish-এর অধীনে, Google API Services ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে I agree to the Google API Services: User Data Policy নির্বাচন করুন।
9. চালিয়ে যান-এ ক্লিক করুন।
10. তৈরি করুন- এ ক্লিক করুন।
3. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace অর্গানাইজেশনের বাইরে ব্যবহারের জন্য কোনো অ্যাপ তৈরি করবেন, তখন আপনাকে অবশ্যই ইউজার টাইপ (User type) পরিবর্তন করে ‘এক্সটার্নাল’ ( External ) করতে হবে। এরপর আপনার অ্যাপের জন্য প্রয়োজনীয় অথরাইজেশন স্কোপগুলো যোগ করুন। আরও জানতে, সম্পূর্ণ ‘কনফিগার OAuth কনসেন্ট’ (Configure OAuth consent) গাইডটি দেখুন।

গুগল চ্যাট অ্যাপ কনফিগার করুন

গুগল চ্যাট এপিআই কল করার জন্য, আপনাকে একটি গুগল চ্যাট অ্যাপ কনফিগার করতে হবে। যেকোনো রাইট রিকোয়েস্টের ক্ষেত্রে, গুগল চ্যাট নিম্নলিখিত তথ্য ব্যবহার করে UI-তে গুগল চ্যাট অ্যাপটিকে অ্যাট্রিবিউট করে।

1. Google API Console-এ, Chat API Configuration পেজে যান:

   চ্যাট এপিআই কনফিগারেশন পৃষ্ঠায় যান

2. অ্যাপ্লিকেশন তথ্য (Application info) অংশে নিম্নলিখিত তথ্যগুলো প্রবেশ করান:

   1. অ্যাপের নামের ফিল্ডে Chat API quickstart app লিখুন।
   2. Avatar URL ফিল্ডে https://developers.google.com/chat/images/quickstart-app-avatar.png লিখুন।
   3. Description ফিল্ডে, Quickstart for calling the Chat API লিখুন।

3. ইন্টারেক্টিভ ফিচারস- এর অধীনে, চ্যাট অ্যাপের ইন্টারেক্টিভ ফিচারগুলো নিষ্ক্রিয় করতে ‘Enable interactive features’ টগলটি অফ অবস্থানে ক্লিক করুন।

4. সংরক্ষণ করুন- এ ক্লিক করুন।

স্ক্রিপ্ট তৈরি করুন

1. script.google.com/create -এ গিয়ে অ্যাপস স্ক্রিপ্ট এডিটরে একটি নতুন স্ক্রিপ্ট তৈরি করুন।
2. স্ক্রিপ্ট এডিটরের বিষয়বস্তু নিম্নলিখিত কোড দিয়ে প্রতিস্থাপন করুন:

/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken,
    });
    // Handle response pages
    if (responsePage.spaces) {
      for (const space of responsePage.spaces) {
        console.log(space);
      }
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

3. সংরক্ষণ করুন ক্লিক করুন .
4. Untitled project-এ ক্লিক করুন, Quickstart টাইপ করুন এবং Rename-এ ক্লিক করুন।

স্ক্রিপ্টটি কনফিগার করুন

ক্লাউড প্রজেক্ট নম্বরটি কপি করুন

1. Google API কনসোলে, menu > IAM ও অ্যাডমিন > সেটিংস- এ যান।

   IAM এবং অ্যাডমিন সেটিংসে যান

2. প্রজেক্ট নম্বর ফিল্ডে মানটি কপি করুন।

আপনার গুগল ক্লাউড প্রজেক্ট লিঙ্ক করুন

1. অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলুন।
2. প্রজেক্ট settings ক্লিক করুন।
3. Google Cloud Platform (GCP) Project- এর অধীনে, Change project-এ ক্লিক করুন।
4. GCP প্রজেক্ট নম্বরের জায়গায় গুগল ক্লাউড প্রজেক্ট নম্বরটি পেস্ট করুন।
5. প্রজেক্ট সেট করুন -এ ক্লিক করুন।

গুগল চ্যাট এপিআই সক্রিয় করুন

অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলুন।

1. প্রজেক্ট settings ক্লিক করুন।
2. সাধারণ সেটিংস- এর অধীনে, এডিটরে 'appsscript.json' ম্যানিফেস্ট ফাইল দেখানোর বিকল্পটি সক্রিয় করুন।
3. 'Editor code ক্লিক করুন, appscript.json ফাইলটি নির্বাচন করুন এবং এর ভেতরের বিষয়বস্তু নিচের কোড দিয়ে প্রতিস্থাপন করুন:

{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": ["https://www.googleapis.com/auth/chat.spaces.readonly"],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [
      {
        "userSymbol": "Chat",
        "version": "v1",
        "serviceId": "chat"
      }
    ]
  }
}

নমুনাটি চালান

অ্যাপস স্ক্রিপ্ট এডিটরে, রান-এ ক্লিক করুন।

আপনি যখন প্রথমবার নমুনাটি চালান, তখন এটি আপনাকে অ্যাক্সেসের অনুমতি দিতে অনুরোধ করে:

1. অনুমতি পর্যালোচনা করতে ক্লিক করুন।
2. একটি অ্যাকাউন্ট বেছে নিন।
3. অনুমতি দিন- এ ক্লিক করুন।

স্ক্রিপ্টটির এক্সিকিউশন লগ উইন্ডোর নীচে প্রদর্শিত হয়।

পরবর্তী পদক্ষেপ

• গুগল অ্যাপস স্ক্রিপ্ট অ্যাডভান্সড সার্ভিসেস ডকুমেন্টেশন
• এপিআই এক্সপ্লোরারে গুগল ওয়ার্কস্পেস এপিআইগুলো ব্যবহার করে দেখুন।