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