Method: courses.courseWork.studentSubmissions.return

Renvoie un devoir d'élève.

Lorsque vous renvoyez un devoir d'élève, la propriété des fichiers Drive joints est transférée à l'élève et l'état du devoir peut également être mis à jour. Contrairement à l'application Classroom, le renvoi d'un devoir d'élève ne définit pas assignedGrade sur la valeur draftGrade.

Seul un enseignant du cours contenant le devoir d'élève demandé peut appeler cette méthode.

Cette requête doit être effectuée par le projet de la console développeur de l'ID client OAuth utilisé pour créer l'élément de travail de cours correspondant ou une pièce jointe complémentaire sur l'élément de travail de cours correspondant.

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

  • PERMISSION_DENIED si l'utilisateur demandeur n'est pas autorisé à accéder au cours ou au travail de cours demandé, à renvoyer le devoir d'élève demandé ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est mal formée.
  • NOT_FOUND si le cours, le travail de cours ou le devoir d'élève demandé n'existe pas.

Requête HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return

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 celui attribué par Classroom ou un alias.
courseWorkId

string

Identifiant du travail de cours.
id

string

Identifiant du devoir d'élève.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est un objet JSON vide.

Niveaux d'accès 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 sur l'autorisation.