Method: courses.courseWork.create

Crée des devoirs.

Le travail de cours qui en résulte (et les envois correspondants des élèves) sont associés au projet de la console pour les développeurs de l'ID client OAuth utilisé pour effectuer la requête. Les requêtes de l'API Classroom visant à modifier les devoirs et les devoirs envoyés par les élèves doivent être effectuées avec un ID client OAuth du projet de la console de développement associé.

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

  • PERMISSION_DENIED si l'utilisateur à l'origine de la demande n'est pas autorisé à accéder au cours demandé, à créer des devoirs dans le cours demandé, à partager une pièce jointe Drive ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est incorrecte.
  • NOT_FOUND si le cours demandé n'existe pas.
  • FAILED_PRECONDITION pour l'erreur de requête suivante :
    • AttachmentNotVisible

Requête HTTP

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

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.

Paramètres de requête

Paramètres
previewVersion

enum (PreviewVersion)

Facultatif. Version preview du point de terminaison. Ce paramètre doit être défini pour accéder aux nouvelles fonctionnalités d'API mises à la disposition des développeurs dans le programme Preview.

Corps de la requête

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

Corps de la réponse

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.coursework.students

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