ভূমিকা

যে শিক্ষকরা ক্লাসরুম এবং থার্ড-পার্টি টুলস উভয়ই ব্যবহার করেন তারা একাধিক প্ল্যাটফর্মে তাদের কোর্স এবং রোস্টার সেট আপ করার চ্যালেঞ্জের মুখোমুখি হন। এটি ম্যানুয়ালি করা যেতে পারে, হয় CSV আপলোড ব্যবহার করে বা একের পর এক ইমেল প্রবেশের মাধ্যমে। ক্লাসরুম API এর সাথে, তবে, তৃতীয় পক্ষের সরঞ্জামগুলি API-এর সবচেয়ে সাধারণ ব্যবহারের ক্ষেত্রে: রোস্টার আমদানির সাথে একীভূত হয়ে তাদের শিক্ষকের কাজের চাপ কমাতে পারে।

রোস্টার ইম্পোর্টিং থার্ড-পার্টি প্ল্যাটফর্মগুলিকে একটি কোর্সের মেটাডেটা, শিক্ষক এবং ছাত্রদের একটি কোর্স-বাই-কোর্স ভিত্তিতে শিক্ষক বা প্রশাসকের অনুমতি নিয়ে পুনরুদ্ধার করতে দেয়৷ শিক্ষকরা যে কোর্সগুলি শেখান তার বিবরণ পুনরুদ্ধার করতে পারেন, যেখানে প্রশাসকদের একটি সম্পূর্ণ ডোমেন জুড়ে সমস্ত কোর্সের বিবরণে অ্যাক্সেস থাকে৷ এই নমনীয়তা ডেভেলপারদের তাদের প্ল্যাটফর্মে ক্লাসরুমের রোস্টারগুলিকে একটি পৃথক-শিক্ষক স্তরে বা পুরো ডোমেন জুড়ে প্রশাসক শংসাপত্র ব্যবহার করে নির্বিঘ্নে অনবোর্ড করার অনুমতি দেয়।

ডোমেন প্রশাসকরা তাদের নিজস্ব কোর্সের শিক্ষক হিসাবে তৃতীয় পক্ষের সরঞ্জামগুলি ব্যবহার করতে পারে। API-এর মাধ্যমে কোর্সের বিবরণ পুনরুদ্ধার করার সময় ডোমেন প্রশাসক এবং শিক্ষকের অনুমতির মধ্যে পার্থক্য যত্ন সহকারে পরিচালনা করা প্রয়োজন।

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

1. তৃতীয় পক্ষের আবেদনে, একজন শিক্ষক ক্লাসরুম কোর্স আমদানি করার বিকল্প বেছে নেন।

2. তৃতীয় পক্ষের অ্যাপ্লিকেশনটি ক্লাসরুম API-এর মাধ্যমে courses.list পদ্ধতিতে কল করে, যা সমস্ত শিক্ষকের কোর্সের সাথে JSON-এর প্রতিক্রিয়া প্রদান করবে।

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

4. নির্বাচিত কোর্স আইডি সহ, তৃতীয় পক্ষের অ্যাপ্লিকেশনটি students.list এবং teachers.list পদ্ধতিগুলিকে কল করে এবং শিক্ষকদের আমদানির জন্য নিশ্চিত করার জন্য তার ওয়েবসাইটে সমস্ত নাম প্রদর্শন করে৷

5. students.list এবং teachers.list রেসপন্স jsons-এ ফিরে আসা ইমেলগুলি ব্যবহার করে, থার্ড-পার্টি অ্যাপ্লিকেশন ব্যবহারকারীদের তাদের প্ল্যাটফর্মে নতুন আমদানি করা কোর্সে যোগ দিতে আমন্ত্রণ জানায়।

কর্মপ্রবাহে উল্লিখিত প্রতিটি পদ্ধতির জন্য, প্রতিটি পদ্ধতি ঠিক কীভাবে আচরণ করে তা দেখতে আপনি API এক্সপ্লোরার ব্যবহার করতে পারেন। এই নির্দেশিকাটি শেষ করার আগে আমরা নিম্নলিখিত প্রাক-পড়ার পরামর্শ দিই:

1. ক্লাসরুম API দিয়ে কোর্স পরিচালনা করুন
2. ছাত্র এবং শিক্ষক পরিচালনা করুন

নিচের ওয়ার্কফ্লো ডায়াগ্রাম ছাড়াও, এই ধরনের ইন্টিগ্রেশনের আরও ভালো ধারণা পেতে ActivelyLearn-এর লাইভ উদাহরণ দেখুন।

শুরু হচ্ছে

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

মাঠ	ব্যবহার করুন
আইডি	শিক্ষার্থী বা শিক্ষকদের পুনরুদ্ধার করার API অনুরোধের জন্য প্রয়োজনীয়
নাম	ব্যবহারকারীর জন্য সহজে ব্যবহারের জন্য প্রস্তাবিত, অর্থাৎ আপনার ওয়েবসাইটে প্রদর্শন করা
মালিক আইডি	একটি কোর্সের প্রধান শিক্ষককে সঠিকভাবে শনাক্ত করার জন্য ডোমেইন-ওয়াইড ভিত্তিতে আমদানি করার সময় প্রয়োজনীয়

এই কোর্সের তথ্য উপরের কর্মপ্রবাহের courses.list ধাপে পুনরুদ্ধার করা হয়েছে। এই অনুরোধে আপনি নির্দিষ্ট অনুরোধের পরামিতি নির্দিষ্ট করতে পারেন। যদিও এই পদ্ধতির জন্য কোনটির প্রয়োজন নেই, কিছু প্রস্তাবিত পরামিতি হল:

প্যারামিটার	ব্যবহার করুন
কোর্স স্টেট	অনির্দিষ্ট রেখে গেলে, API ছয়টি কোর্সের সমস্ত রাজ্যের কোর্স ফিরিয়ে দেবে। শিক্ষকরা বর্তমানে যে কোর্সগুলি ব্যবহার করছেন তা পুনরুদ্ধার করতে আমরা ACTIVE উল্লেখ করার পরামর্শ দিই৷
পাতার আকার	যেসব শিক্ষক তাদের নিজস্ব কোর্স আমদানি করছেন, আমরা API কলের প্রতিক্রিয়া সময় কমাতে একটি ছোট (10-এর কম) পৃষ্ঠার আকার নির্দিষ্ট করার সুপারিশ করি৷
পেজ টোকেন	আপনি যদি পৃষ্ঠাযুক্ত অনুরোধগুলি ব্যবহার করেন তবে প্রয়োজনীয়৷
শিক্ষক আইডি	প্রস্তাবিত যেহেতু ডোমেইন অ্যাডমিনরা প্রায়ই কোর্স শেখান। অনির্দিষ্ট রেখে দেওয়া হয়েছে, অনুরোধটি পুরো ডোমেন জুড়ে শিক্ষকদের জন্য কোর্স ফিরিয়ে দেবে।
ক্ষেত্র	API কলের প্রতিক্রিয়া সময় কমানোর জন্য সুপারিশ করা হয়।

আগে পুনরুদ্ধার করা কোর্স আইডি ব্যবহার করে, আপনার অ্যাপ্লিকেশন এখন সেই কোর্স বা কোর্সের জন্য ছাত্র এবং সহ-শিক্ষকদের তালিকা পুনরুদ্ধার করতে পারে। এই কোর্স আইডি টি teachers.list এবং students.list এর জন্য একমাত্র প্রয়োজনীয় ক্যোয়ারী প্যারামিটার, কিন্তু আপনি একইভাবে আপনার API কলগুলির প্রতিক্রিয়ার সময় কমাতে pageSize এবং fields পরামিতিগুলি নির্দিষ্ট করার কথা বিবেচনা করতে চাইতে পারেন৷

ছাত্র এবং শিক্ষক সম্পদের জন্য সমস্ত উপলব্ধ ক্ষেত্র তাদের নিজ নিজ ডকুমেন্টেশনে পাওয়া যাবে। দুটি সাধারণত ব্যবহৃত এবং সাধারণত প্রয়োজনীয় ক্ষেত্রগুলি profile ক্ষেত্রে রয়েছে: profile.name এবং profile.emailAddress ।

মাঠ	ব্যবহার করুন
প্রোফাইল নাম	ব্যবহারকারীর জন্য সহজে ব্যবহারের জন্য প্রস্তাবিত, অর্থাৎ আপনার ওয়েবসাইটে প্রদর্শন করা
profile.emailAddress	স্টুডেন্টদের স্বতন্ত্রভাবে শনাক্ত করার জন্য অ্যাপ্লিকেশনের জন্য প্রয়োজনীয়

ক্লাসরুম থেকে এই কোর্স বা তালিকার বিশদগুলির যেকোনো একটি পুনরুদ্ধার করতে এবং ব্যবহার করতে, আপনার অ্যাপ্লিকেশনকে ব্যবহারকারীদের কাছ থেকে অনুমোদনের অনুরোধ করতে হবে। এই ওয়ার্কফ্লো বাস্তবায়নের জন্য তিনটি (3) প্রয়োজনীয় সুযোগ রয়েছে:

• https://www.googleapis.com/auth/classroom.courses.readonly
  • Google ক্লাসরুম কোর্সে শুধুমাত্র-পঠন অ্যাক্সেস প্রদান করে
• https://www.googleapis.com/auth/classroom.rosters.readonly
  • Google ক্লাসরুম কোর্সের (শিক্ষক এবং ছাত্রদের) রোস্টারগুলিতে শুধুমাত্র-পঠন অ্যাক্সেস প্রদান করে
• https://www.googleapis.com/auth/classroom.profile.emails
  • শিক্ষক এবং ছাত্রদের ইমেল সম্পত্তি পড়ার অ্যাক্সেস প্রদান করে

যেহেতু এই সুযোগগুলির মধ্যে একটিকে সংবেদনশীল বলে মনে করা হয়, আপনার আবেদনের একটি যাচাইকরণ প্রক্রিয়া সম্পন্ন করতে হবে৷

পাব/সাব বিজ্ঞপ্তিগুলির সাথে রোস্টারগুলিকে সিঙ্ক করুন৷

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

আপনার অ্যাপ্লিকেশনের ব্যবহারের ক্ষেত্রে নির্ভর করে, আপনি একটি কোর্স-বাই-কোর্স বা ডোমেন ভিত্তিতে বিজ্ঞপ্তিগুলিতে সদস্যতা নিতে পারেন।

পুশ বিজ্ঞপ্তিগুলি ব্যবহার করার জন্য একটি অতিরিক্ত সুযোগের প্রয়োজন হবে, যা যাচাইয়ের জন্য জমা দিতে হবে না:

• https://www.googleapis.com/auth/classroom.push-notifications
  • আপনার অ্যাপকে যেকোনো পুশ বিজ্ঞপ্তি কার্যকলাপের জন্য নিবন্ধন করার অনুমতি দেয়

ক্লাসরুম পুশ বিজ্ঞপ্তিগুলির সাথে কীভাবে একীভূত করা যায় সে সম্পর্কে আরও বিশদ বিবরণের জন্য, আমাদের পুশ বিজ্ঞপ্তি পরিচালনা পরিচালনা দেখুন।