Une ressource thématique représente un groupe d'éléments de flux classés par similarité, tels que la semaine attribuée ou le sujet du cours.
Chaque sujet est identifié par un identifiant unique attribué par le serveur. Cet ID est associé à l'ID du cours auquel le thème appartient, au nom réel du thème affiché dans l'interface utilisateur Classroom, ainsi qu'à la date et à l'heure de la dernière mise à jour.
Créer un sujet
Vous pouvez créer un sujet dans un cours à l'aide de la méthode topics.create()
, comme illustré dans l'exemple suivant:
Java
Python
topic = {
"name": 'Example Topic'
}
response = service.courses().topics().create(
courseId=<course ID or alias>,
body=topic).execute()
print('Topic created: ', response['name'])
Récupérer les détails du thème
Vous pouvez récupérer les thèmes d'un cours correspondant à l'aide de la méthode topics.get()
, comme illustré dans l'exemple suivant:
Java
Python
response = service.courses().topics().get(
courseId=<course ID or alias>,
id=<topic ID>).execute()
print('{0} ({1})'.format(response['name'], response['topicId']))
Pour obtenir la liste des cours, utilisez la méthode topics.list()
, comme indiqué dans l'exemple suivant:
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']))
Mettre à jour les sujets
Vous pouvez mettre à jour le nom d'un sujet existant avec la méthode topics.patch()
, comme illustré dans l'exemple suivant:
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']))
Supprimer des sujets
Vous pouvez supprimer un sujet existant à l'aide de la méthode topics.delete()
, comme illustré dans l'exemple suivant: