Method: courses.topics.create

Crée un sujet.

Cette méthode renvoie les codes d'erreur suivants:

  • PERMISSION_DENIED si l'utilisateur à l'origine de la requête n'est pas autorisé à accéder au cours demandé, à créer un sujet dans le cours demandé ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est incorrecte.
  • ALREADY_EXISTS si un sujet du cours porte le même nom.
  • FAILED_PRECONDITION pour l'erreur de requête suivante :
    • CourseTopicLimitReached
  • NOT_FOUND si le cours demandé n'existe pas.

Requête HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/topics

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Identifiant du cours. Cet identifiant peut être l'identifiant attribué par Classroom ou un alias.

Corps de la requête

Le corps de la requête contient une instance de Topic.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Topic.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.topics

Pour en savoir plus, consultez le guide d'autorisation.