Node.js quickstart

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

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

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

উদ্দেশ্য

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

পূর্বশর্ত

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

  • API অ্যাক্সেস সক্ষম সহ একটি Google Workspace ডোমেন।
  • প্রশাসকের বিশেষাধিকার সহ সেই ডোমেনে একটি Google অ্যাকাউন্ট।

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

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

API সক্ষম করুন

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

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

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

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

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

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

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

    ক্লায়েন্টে যান

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

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

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

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

  • এনপিএম ব্যবহার করে লাইব্রেরি ইনস্টল করুন:

    npm install googleapis@105 @google-cloud/local-auth@2.1.0 --save

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

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

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

    adminSDK/reports/index.js
    import path from 'node:path';
import process from 'node:process';
import {authenticate} from '@google-cloud/local-auth';
import {google} from 'googleapis';

// The scope for the Admin SDK Reports API.
const SCOPES = ['https://www.googleapis.com/auth/admin.reports.audit.readonly'];
// The path to the credentials file.
const CREDENTIALS_PATH = path.join(process.cwd(), 'credentials.json');

/**
 * Lists the last 10 login events for the domain.
 */
async function listLoginEvents() {
  // Authenticate with Google and get an authorized client.
  const auth = await authenticate({
    scopes: SCOPES,
    keyfilePath: CREDENTIALS_PATH,
  });

  // Create a new Admin SDK Reports API client.
  const service = google.admin({version: 'reports_v1', auth});
  // Get the list of login events.
  const result = await service.activities.list({
    userKey: 'all',
    applicationName: 'login',
    maxResults: 10,
  });
  const activities = result.data.items;
  if (!activities || activities.length === 0) {
    console.log('No logins found.');
    return;
  }

  // Print the time, email, and event name of each login event.
  console.log('Logins:');
  activities.forEach((activity) => {
    console.log(
      `${activity.id?.time}: ${activity.actor?.email} (${activity.events?.[0]?.name})`,
    );
  });
}

await listLoginEvents();

নমুনা চালান

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

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

    আপনার Nodejs অ্যাপ্লিকেশন রান করে এবং অ্যাডমিন SDK API-কে কল করে।

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

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