แหล่งข้อมูลหัวข้อแสดงกลุ่มรายการสตรีมที่จัดหมวดหมู่ตามความคล้ายคลึงกัน เช่น สัปดาห์ที่มอบหมายหรือวิชาของหลักสูตร
แต่ละหัวข้อจะถูกระบุโดยรหัสที่ไม่ซ้ำกันที่เซิร์ฟเวอร์กำหนด รหัสนี้คือรหัสหลักสูตรของหัวข้อ ชื่อหัวข้อจริงที่แสดงใน UI ของ 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()
ดังที่แสดงในตัวอย่างต่อไปนี้