Node.js quickstart

একটি Node.js কমান্ড-লাইন অ্যাপ্লিকেশন তৈরি করুন যা Google Chat API-তে অনুরোধ করে।

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

এই কুইকস্টার্টটি প্রমাণীকরণ এবং অনুমোদন প্রবাহের কিছু বিবরণ পরিচালনা করতে Google Workspace-এর প্রস্তাবিত API ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

উদ্দেশ্য

  • তোমার পরিবেশ ঠিক করো।
  • ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
  • নমুনা সেট আপ করুন।
  • নমুনাটি চালান।

পূর্বশর্ত

এই কুইকস্টার্টটি চালানোর জন্য, আপনার নিম্নলিখিত পূর্বশর্তগুলি প্রয়োজন:

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

আপনার পরিবেশ সেট আপ করুন

এই দ্রুত শুরুটি সম্পন্ন করতে, আপনার পরিবেশ সেট আপ করুন।

API সক্রিয় করুন

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

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

  1. গুগল ক্লাউড কনসোলে, মেনু > এ যানGoogle Auth platform > ব্র্যান্ডিং ।

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

  2. যদি আপনি ইতিমধ্যেই কনফিগার করে থাকেন Google Auth platform, আপনি ব্র্যান্ডিং , অডিয়েন্স এবং ডেটা অ্যাক্সেসে নিম্নলিখিত OAuth কনসেন্ট স্ক্রিন সেটিংস কনফিগার করতে পারেন। যদি আপনি এমন একটি বার্তা দেখতে পান যা বলে Google Auth platform এখনও কনফিগার করা হয়নি , শুরু করুন ক্লিক করুন:
    1. অ্যাপ তথ্য এর অধীনে, অ্যাপের নামে , অ্যাপটির জন্য একটি নাম লিখুন।
    2. ব্যবহারকারীর সহায়তা ইমেল বিভাগে, এমন একটি সহায়তা ইমেল ঠিকানা বেছে নিন যেখানে ব্যবহারকারীদের সম্মতি সম্পর্কে প্রশ্ন থাকলে তারা আপনার সাথে যোগাযোগ করতে পারবেন।
    3. পরবর্তী ক্লিক করুন।
    4. অডিয়েন্স এর অধীনে, অভ্যন্তরীণ নির্বাচন করুন।
    5. পরবর্তী ক্লিক করুন।
    6. যোগাযোগের তথ্য এর অধীনে, একটি ইমেল ঠিকানা লিখুন যেখানে আপনার প্রকল্পের যেকোনো পরিবর্তন সম্পর্কে আপনাকে অবহিত করা যেতে পারে।
    7. পরবর্তী ক্লিক করুন।
    8. Finish এর অধীনে, Google API পরিষেবা ব্যবহারকারীর ডেটা নীতি পর্যালোচনা করুন এবং যদি আপনি সম্মত হন, তাহলে আমি Google API পরিষেবাগুলিতে সম্মত: ব্যবহারকারীর ডেটা নীতি নির্বাচন করুন।
    9. চালিয়ে যান ক্লিক করুন।
    10. তৈরি করুন ক্লিক করুন।
  3. আপাতত, আপনি স্কোপ যোগ করা এড়িয়ে যেতে পারেন। ভবিষ্যতে, যখন আপনি আপনার Google Workspace সংস্থার বাইরে ব্যবহারের জন্য একটি অ্যাপ তৈরি করবেন, তখন আপনাকে ব্যবহারকারীর ধরণটি External এ পরিবর্তন করতে হবে। তারপর আপনার অ্যাপের জন্য প্রয়োজনীয় অনুমোদনের স্কোপগুলি যোগ করুন। আরও জানতে, সম্পূর্ণ Configure OAuth সম্মতি নির্দেশিকাটি দেখুন।

একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য শংসাপত্র অনুমোদন করুন

আপনার অ্যাপে ব্যবহারকারীদের প্রমাণীকরণ এবং ব্যবহারকারীর ডেটা অ্যাক্সেস করার জন্য, আপনাকে এক বা একাধিক OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে হবে। Google এর OAuth সার্ভারগুলিতে একটি একক অ্যাপ সনাক্ত করতে একটি ক্লায়েন্ট আইডি ব্যবহার করা হয়। যদি আপনার অ্যাপ একাধিক প্ল্যাটফর্মে চলে, তাহলে আপনাকে প্রতিটি প্ল্যাটফর্মের জন্য একটি পৃথক ক্লায়েন্ট আইডি তৈরি করতে হবে।
  1. গুগল ক্লাউড কনসোলে, মেনু > এ যানGoogle Auth platform > ক্লায়েন্ট ।

    ক্লায়েন্টদের তালিকায় যান

  2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
  3. অ্যাপ্লিকেশনের ধরণ > ডেস্কটপ অ্যাপ ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হবে।
  5. তৈরি করুন ক্লিক করুন।

    নতুন তৈরি শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

  6. ডাউনলোড করা JSON ফাইলটি credentials.json হিসেবে সংরক্ষণ করুন এবং ফাইলটিকে আপনার ওয়ার্কিং ডিরেক্টরিতে সরান।

Google Chat অ্যাপ কনফিগার করুন

Google Chat API কল করতে, আপনাকে একটি Google Chat অ্যাপ কনফিগার করতে হবে। যেকোনো লেখার অনুরোধের জন্য, Google Chat নিম্নলিখিত তথ্য ব্যবহার করে UI-তে Google Chat অ্যাপটিকে অ্যাট্রিবিউট করে।

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

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

  2. অ্যাপ্লিকেশন তথ্য এর অধীনে, নিম্নলিখিত তথ্য লিখুন:

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

  3. ইন্টারেক্টিভ বৈশিষ্ট্যগুলির অধীনে, চ্যাট অ্যাপের জন্য ইন্টারেক্টিভ বৈশিষ্ট্যগুলি অক্ষম করতে ইন্টারেক্টিভ বৈশিষ্ট্যগুলি সক্ষম করুন টগল অফ পজিশনে ক্লিক করুন।

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

ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন

  • npm ব্যবহার করে লাইব্রেরিগুলি ইনস্টল করুন:

    npm install @google-apps/chat @google-cloud/local-auth@2.1.0 --save

নমুনা সেট আপ করুন

  1. আপনার ওয়ার্কিং ডিরেক্টরিতে, index.js নামে একটি ফাইল তৈরি করুন।

  2. ফাইলটিতে, নিম্নলিখিত কোডটি পেস্ট করুন:

    চ্যাট/কুইকস্টার্ট/ইন্ডেক্স.জেএস
    import path from 'node:path';
import process from 'node:process';
import {ChatServiceClient} from '@google-apps/chat';
import {authenticate} from '@google-cloud/local-auth';

// The scope for reading Chat spaces.
const SCOPES = ['https://www.googleapis.com/auth/chat.spaces.readonly'];
// The path to the credentials file.
const CREDENTIALS_PATH = path.join(process.cwd(), 'credentials.json');

/**
 * Lists the spaces that the user is a member of.
 */
async function listSpaces() {
  // Authenticate with Google and get an authorized client.
  const authClient = await authenticate({
    scopes: SCOPES,
    keyfilePath: CREDENTIALS_PATH,
  });

  // Create a new Chat API client.
  const chatClient = new ChatServiceClient({
    authClient,
    scopes: SCOPES,
  });

  // The request to list spaces.
  const request = {
    // Filter spaces by type. In this case, we are only interested in "SPACE" type.
    filter: 'space_type = "SPACE"',
  };

  // Make the API request.
  const pageResult = chatClient.listSpacesAsync(request);

  // Process the response.
  // The `pageResult` is an async iterable that will yield each space.
  for await (const response of pageResult) {
    console.log(response);
  }
}

await listSpaces();

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

  1. আপনার কার্যকরী ডিরেক্টরিতে, নমুনাটি চালান:

    node .
  1. প্রথমবার যখন আপনি নমুনাটি চালাবেন, তখন এটি আপনাকে অ্যাক্সেস অনুমোদন করার জন্য অনুরোধ করবে:
    1. যদি আপনি ইতিমধ্যেই আপনার Google অ্যাকাউন্টে সাইন ইন না করে থাকেন, তাহলে অনুরোধ করা হলে সাইন ইন করুন। যদি আপনি একাধিক অ্যাকাউন্টে সাইন ইন করে থাকেন, তাহলে অনুমোদনের জন্য ব্যবহার করার জন্য একটি অ্যাকাউন্ট নির্বাচন করুন।
    2. গ্রহণ করুন ক্লিক করুন।

    আপনার Nodejs অ্যাপ্লিকেশনটি Google Chat API চালায় এবং কল করে।

    অনুমোদনের তথ্য ফাইল সিস্টেমে সংরক্ষণ করা হয়, তাই পরের বার যখন আপনি নমুনা কোডটি চালাবেন, তখন আপনাকে অনুমোদনের জন্য অনুরোধ করা হবে না।

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