विषय से जुड़ा संसाधन, स्ट्रीम आइटम के ऐसे ग्रुप को दिखाता है जिन्हें एक जैसी चीज़ों के आधार पर कैटगरी में बांटा गया है. जैसे, असाइन किया गया हफ़्ता या कोर्स का विषय.
हर विषय की पहचान, सर्वर से असाइन किए गए यूनीक आईडी से की जाती है. इस आईडी से, उस कोर्स का आईडी जुड़ा होता है जिससे विषय जुड़ा है. साथ ही, Classroom के यूज़र इंटरफ़ेस (यूआई) पर दिखने वाला विषय का असल नाम और पिछली बार अपडेट करने की तारीख और समय भी जुड़ा होता है.
विषय बनाना
किसी कोर्स में नया विषय बनाने के लिए, topics.create()
तरीके का इस्तेमाल किया जा सकता है. इस तरीके के बारे में यहां दिए गए सैंपल में बताया गया है:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
विषय की जानकारी पाना
topics.get()
तरीके का इस्तेमाल करके, किसी कोर्स के विषयों को वापस पाया जा सकता है. इसका उदाहरण यहां दिया गया है:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
कोर्स की सूची के लिए, topics.list()
तरीके का इस्तेमाल करें, जैसा कि नीचे दिए गए सैंपल में दिखाया गया है:
Java
Python
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()
तरीका अपनाएं. उदाहरण के लिए:
Java
Python
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']))
विषय मिटाना
किसी मौजूदा विषय को मिटाने के लिए, topics.delete()
तरीके का इस्तेमाल किया जा सकता है. इस तरीके के बारे में यहां दिए गए सैंपल में बताया गया है: