যেসব শিক্ষক ক্লাসরুম এবং থার্ড-পার্টি টুল উভয়ই ব্যবহার করেন, তাদের একাধিক প্ল্যাটফর্মে তাদের কোর্স এবং রোস্টার সেট আপ করার চ্যালেঞ্জের মুখোমুখি হতে হয়। এটি ম্যানুয়ালি করা যেতে পারে, হয় CSV আপলোড ব্যবহার করে অথবা একের পর এক ইমেল প্রবেশ করানোর মাধ্যমে। তবে, ক্লাসরুম API-এর মাধ্যমে, থার্ড-পার্টি টুলগুলি API-এর সবচেয়ে সাধারণ ব্যবহারের ক্ষেত্রে: রোস্টার আমদানির সাথে একীভূত করে তাদের শিক্ষকদের কাজের চাপ কমাতে পারে।
রোস্টার ইমপোর্টিং থার্ড-পার্টি প্ল্যাটফর্মগুলিকে শিক্ষক বা প্রশাসকের অনুমতি নিয়ে কোর্স-বাই-কোর্স ভিত্তিতে একটি কোর্সের মেটাডেটা, শিক্ষক এবং শিক্ষার্থীদের পুনরুদ্ধার করার অনুমতি দেয়। শিক্ষকরা তাদের পড়ানো কোর্সের বিশদ বিবরণ পুনরুদ্ধার করতে পারেন, যেখানে প্রশাসকরা একটি সম্পূর্ণ ডোমেন জুড়ে সমস্ত কোর্সের বিশদ বিবরণে অ্যাক্সেস পান। এই নমনীয়তা ডেভেলপারদের অ্যাডমিন শংসাপত্র ব্যবহার করে পৃথক-শিক্ষক স্তরে বা সম্পূর্ণ ডোমেন জুড়ে তাদের প্ল্যাটফর্মে ক্লাসরুম রোস্টারগুলিকে নির্বিঘ্নে অনবোর্ড করার অনুমতি দেয়।
একটি রোস্টার ইম্পোর্ট ইন্টিগ্রেশন কেমন হতে পারে তার প্রযুক্তিগত বিবরণে ডুব দেওয়ার আগে, প্রথমে একটি উদাহরণ ওয়ার্কফ্লো পর্যালোচনা করা যাক:
তৃতীয় পক্ষের আবেদনে, একজন শিক্ষক একটি ক্লাসরুম কোর্স আমদানি করার বিকল্পটি বেছে নেন।
তৃতীয় পক্ষের অ্যাপ্লিকেশনটি Classroom API এর মাধ্যমে
courses.listপদ্ধতিতে কল করে, যা সমস্ত শিক্ষকের কোর্সের সাথে একটি প্রতিক্রিয়া JSON প্রদান করবে।json রেসপন্স থেকে, থার্ড-পার্টি অ্যাপ্লিকেশনটি শিক্ষকদের কোর্সের শিরোনাম প্রদর্শন করে যাতে তারা একটি নির্বাচন করতে পারে। পরবর্তী ধাপে এগিয়ে যাওয়ার জন্য অ্যাপ্লিকেশনটিকে কোর্স আইডিগুলির ট্র্যাক রাখতে হবে।
নির্বাচিত কোর্স আইডি সহ, তৃতীয় পক্ষের অ্যাপ্লিকেশনটি
students.listএবংteachers.listপদ্ধতিগুলিকে কল করে এবং শিক্ষকদের আমদানির জন্য নিশ্চিত করার জন্য তাদের ওয়েবসাইটে সমস্ত নাম প্রদর্শন করে।students.listএবংteachers.listরেসপন্স jsons-এ ফিরে আসা ইমেলগুলি ব্যবহার করে, তৃতীয় পক্ষের অ্যাপ্লিকেশনটি ব্যবহারকারীদের তাদের প্ল্যাটফর্মে নতুন আমদানি করা কোর্সে যোগদানের জন্য আমন্ত্রণ জানায়।
ওয়ার্কফ্লোতে উল্লিখিত প্রতিটি পদ্ধতির জন্য, প্রতিটি পদ্ধতি ঠিক কীভাবে আচরণ করে তা দেখতে আপনি API এক্সপ্লোরার ব্যবহার করতে পারেন। এই নির্দেশিকাটি শেষ করার আগে আমরা নিম্নলিখিত প্রাক-পঠনগুলিও সুপারিশ করছি:
শুরু করা
আপনার ক্লাসরুম রোস্টার আমদানির সুনির্দিষ্ট বৈশিষ্ট্যগুলি বাস্তবায়নের আগে, আপনাকে API এর মাধ্যমে কোন কোর্স এবং ব্যবহারকারীর তথ্য পুনরুদ্ধার করতে হবে তা নির্ধারণ করতে হবে। আপনি রেফারেন্স ডকুমেন্টেশনে কোন কোর্স মেটাডেটা উপলব্ধ তা দেখতে পারেন, তবে প্রয়োজনীয় কিছু প্রয়োজনীয় বা সাধারণ ক্ষেত্র নীচে সংক্ষেপে দেওয়া যেতে পারে:
| মাঠ | ব্যবহার করুন |
|---|---|
| আইডি | শিক্ষার্থী বা শিক্ষকদের পুনরুদ্ধারের API অনুরোধের জন্য প্রয়োজনীয় |
| নাম | ব্যবহারকারীর ব্যবহারের সুবিধার জন্য, অর্থাৎ আপনার ওয়েবসাইটে প্রদর্শনের জন্য প্রস্তাবিত |
| মালিক আইডি | কোনও কোর্সের প্রধান শিক্ষককে সঠিকভাবে সনাক্ত করার জন্য ডোমেন-ওয়াইড ভিত্তিতে আমদানি করার সময় প্রয়োজনীয় |
এই কোর্সের তথ্য উপরের ওয়ার্কফ্লোর courses.list ধাপে পুনরুদ্ধার করা হয়েছে। এই অনুরোধে আপনি নির্দিষ্ট অনুরোধের প্যারামিটার নির্দিষ্ট করতে পারেন। যদিও এই পদ্ধতির জন্য কোনওটিই প্রয়োজন হয় না, কিছু প্রস্তাবিত প্যারামিটার হল:
| প্যারামিটার | ব্যবহার করুন |
|---|---|
| কোর্সস্টেট | নির্দিষ্ট না করে, API ছয়টি কোর্সের সমস্ত অবস্থার কোর্স ফিরিয়ে দেবে। শিক্ষকরা বর্তমানে যে কোর্সগুলি ব্যবহার করছেন তা পুনরুদ্ধার করতে আমরা ACTIVE নির্দিষ্ট করার পরামর্শ দিচ্ছি। |
| পৃষ্ঠার আকার | যেসব শিক্ষক তাদের নিজস্ব কোর্স আমদানি করছেন, তাদের জন্য আমরা API কলের প্রতিক্রিয়া সময় কমাতে একটি ছোট (১০ এর কম) পৃষ্ঠার আকার নির্দিষ্ট করার পরামর্শ দিচ্ছি। |
| পেজটোকেন | আপনি যদি পৃষ্ঠাযুক্ত অনুরোধ ব্যবহার করেন তবে এটি প্রয়োজন। |
| শিক্ষক আইডি | ডোমেন প্রশাসকরা প্রায়শই কোর্স পড়ান বলে এটি সুপারিশ করা হচ্ছে। নির্দিষ্ট না করে থাকলে, অনুরোধটি সমগ্র ডোমেন জুড়ে শিক্ষকদের জন্য কোর্সগুলি ফিরিয়ে দেবে। |
| ক্ষেত্র | API কলের প্রতিক্রিয়া সময় কমানোর পরামর্শ দেওয়া হচ্ছে। |
পূর্বে পুনরুদ্ধার করা কোর্স আইডি ব্যবহার করে, আপনার অ্যাপ্লিকেশনটি এখন সেই কোর্স বা কোর্সের জন্য শিক্ষার্থী এবং সহ-শিক্ষকদের তালিকা পুনরুদ্ধার করতে পারে। এই কোর্স আইডিটি teachers.list এবং students.list এর জন্য একমাত্র প্রয়োজনীয় ক্যোয়ারী প্যারামিটার, তবে আপনি একইভাবে আপনার API কলের প্রতিক্রিয়া সময় কমাতে pageSize এবং fields প্যারামিটারগুলি নির্দিষ্ট করার কথা বিবেচনা করতে পারেন।
শিক্ষার্থী এবং শিক্ষকের জন্য উপলব্ধ সমস্ত ক্ষেত্র তাদের নিজ নিজ ডকুমেন্টেশনে পাওয়া যাবে। সর্বাধিক ব্যবহৃত এবং সাধারণত প্রয়োজনীয় দুটি ক্ষেত্র হল profile ক্ষেত্রে: profile.name এবং profile.emailAddress ।
| মাঠ | ব্যবহার করুন |
|---|---|
| প্রোফাইল.নাম | ব্যবহারকারীর ব্যবহারের সুবিধার জন্য, অর্থাৎ আপনার ওয়েবসাইটে প্রদর্শনের জন্য প্রস্তাবিত |
| প্রোফাইল.ইমেইল ঠিকানা | শিক্ষার্থীদের স্বতন্ত্রভাবে সনাক্ত করতে চাওয়া অ্যাপ্লিকেশনগুলির জন্য প্রয়োজনীয় |
ক্লাসরুম থেকে এই কোর্স বা রোস্টারের যেকোনো বিবরণ পুনরুদ্ধার এবং ব্যবহার করতে, আপনার অ্যাপ্লিকেশনটিকে ব্যবহারকারীদের কাছ থেকে অনুমোদনের অনুরোধ করতে হবে। এই কর্মপ্রবাহ বাস্তবায়নের জন্য তিনটি (3) প্রয়োজনীয় সুযোগ রয়েছে:
- https://www.googleapis.com/auth/classroom.courses.readonly
- গুগল ক্লাসরুম কোর্সগুলিতে কেবল পঠনযোগ্য অ্যাক্সেস প্রদান করে
- https://www.googleapis.com/auth/classroom.rosters.readonly
- গুগল ক্লাসরুম কোর্সের (শিক্ষক এবং শিক্ষার্থী) তালিকাগুলিতে কেবল-পঠনযোগ্য অ্যাক্সেস প্রদান করে।
- https://www.googleapis.com/auth/classroom.profile.emails
- শিক্ষক এবং শিক্ষার্থীদের ইমেল সম্পত্তিতে পড়ার অ্যাক্সেস প্রদান করে।
পাব/সাব বিজ্ঞপ্তির সাথে রোস্টার সিঙ্ক করুন
স্কুল বছর এগিয়ে যাওয়ার সাথে সাথে, শিক্ষার্থীরা কোর্স বাদ দিলে বা যোগ করলে রোস্টার পরিবর্তন হতে পারে। পাব/সাব বিজ্ঞপ্তি যোগ করলে আপনি আপনার তৃতীয়-পক্ষের অ্যাপ্লিকেশনটি ক্লাসরুম রোস্টারের সাথে সিঙ্ক করতে পারবেন। বিজ্ঞপ্তি পেতে, আপনি একটি Google ক্লাউড পাব/সাব বিষয় সেট আপ করেন এবং তারপর ক্লাসরুম API-এর সাথে বিষয়টি নিবন্ধন করেন। এই নিবন্ধনটি ক্লাসরুমের জন্য প্রদত্ত ফিড থেকে প্রদত্ত বিষয়ে ডেটা পাঠানোর অনুরোধ। এই ফিডটি একজন শিক্ষকের ক্লাসরুম রোস্টারের সাথে পুনরায় সিঙ্ক করার জন্য ইভেন্ট ট্রিগার হবে।
পুশ নোটিফিকেশন ব্যবহারের জন্য অতিরিক্ত একটি সুযোগের প্রয়োজন হবে, যা যাচাইয়ের জন্য জমা দিতে হবে না:
- https://www.googleapis.com/auth/classroom.push-notifications
- আপনার অ্যাপকে যেকোনো পুশ নোটিফিকেশন কার্যকলাপের জন্য নিবন্ধন করার অনুমতি দেয়
ক্লাসরুম পুশ নোটিফিকেশনের সাথে কীভাবে একীভূত করবেন সে সম্পর্কে আরও তথ্যের জন্য, আমাদের পুশ নোটিফিকেশন পরিচালনা করুন নির্দেশিকাটি দেখুন।