একটি Topic
হল CourseWork
এবং CourseWorkMaterial
স্ট্রিম আইটেমগুলিকে একটি কোর্সের মধ্যে গ্রুপ করার জন্য একটি লেবেল৷ একটি Topic
সাধারণত এই আইটেমগুলিকে সাদৃশ্য দ্বারা শ্রেণীবদ্ধ করতে ব্যবহৃত হয়, যেমন আইটেমগুলি বরাদ্দ করা সপ্তাহ বা তাদের বিষয়। ব্যবহারকারীরা ক্লাসরুম UI-এর ক্লাসওয়ার্ক ভিউতে স্ট্রিম আইটেমগুলি দৃশ্যত সংগঠিত এবং ফিল্টার করতে পারেন।
প্রতিটি Topic
সার্ভার দ্বারা নির্ধারিত একটি অনন্য ID দ্বারা চিহ্নিত করা হয়। Topic
সম্পদ এছাড়াও নিম্নলিখিত রয়েছে:
-
name
: ক্লাসরুম UI-তে প্রদর্শিত ডিসপ্লে নাম -
updateTime
: যে সময়Topic
শেষবার আপডেট করা হয়েছিল -
courseId
:Topic
সাথে সংশ্লিষ্ট কোর্সের আইডি
একটি বিষয় তৈরি করুন
আপনি topics.create()
পদ্ধতি ব্যবহার করে একটি কোর্সে একটি নতুন Topic
তৈরি করতে পারেন, যেমনটি নিম্নলিখিত নমুনায় দেখানো হয়েছে:
জাভা
পাইথন
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
name
ক্ষেত্রটি সর্বদা প্রয়োজন এবং অবশ্যই একটি অ-খালি স্ট্রিং হতে হবে। অন্য সব ক্ষেত্র ঐচ্ছিক.
বিষয় বিবরণ পুনরুদ্ধার করুন
আপনি topics.get()
পদ্ধতির মাধ্যমে আইডি দ্বারা একটি নির্দিষ্ট Topic
পুনরুদ্ধার করতে পারেন, যেমনটি নিম্নলিখিত নমুনায় দেখানো হয়েছে:
জাভা
পাইথন
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
একটি কোর্সের সমস্ত Topic
পুনরুদ্ধার করতে topics.list()
পদ্ধতিটি ব্যবহার করুন, যেমনটি নিম্নলিখিত নমুনায় দেখানো হয়েছে:
জাভা
পাইথন
topics = []
page_token = None
while True:
response = service.courses().topics().list(
pageToken=page_token,
pageSize=30,
courseId=<course ID or alias>).execute()
topics.extend(response.get('topic', []))
page_token = response.get('nextPageToken', None)
if not page_token:
break
if not topics:
print('No topics found.')
else:
print('Topics:')
for topic in topics:
print('{0} ({1})'.format(topic['name'], topic['topicId']))
একটি বিষয় আপডেট করুন
আপনি topics.patch()
পদ্ধতির সাথে একটি বিদ্যমান Topic
name
আপডেট করতে পারেন, যেমনটি নিম্নলিখিত নমুনায় দেখানো হয়েছে:
জাভা
পাইথন
topic = {
"name": "New Topic Name"
}
response = service.courses().topics().patch(
courseId=<course ID or alias>,
id=<topic ID>,
updateMask="name",
body=topic).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Topic
id
এবং updateTime
ক্ষেত্রগুলি সার্ভার-জেনারেট করা হয় এবং API এর সাথে আপডেট করা যায় না।
একটি বিষয় মুছুন
আপনি topics.delete()
পদ্ধতির মাধ্যমে একটি বিদ্যমান Topic
মুছে ফেলতে পারেন, যেমনটি নিম্নলিখিত নমুনায় দেখানো হয়েছে: