विषय के लिए संसाधन, स्ट्रीम आइटम के ऐसे ग्रुप को दिखाता है जिसे समानता के हिसाब से अलग-अलग कैटगरी में बांटा जाता है. जैसे, असाइन किया गया हफ़्ता या कोर्स का विषय.
हर विषय की पहचान सर्वर से असाइन किए गए एक यूनीक आईडी से की जाती है. इस आईडी से, विषय का कोर्स आईडी, 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()
तरीके का इस्तेमाल करके किसी मौजूदा विषय को मिटाया जा सकता है: