Method: courses.courseWork.studentSubmissions.reclaim

Récupère un devoir d'élève pour le compte de l'élève qui en est le propriétaire.

La récupération d'un devoir d'élève transfère la propriété des fichiers Drive joints à l'élève et met à jour l'état du devoir.

Seul l'élève propriétaire du devoir demandé peut appeler cette méthode, et uniquement pour un devoir qui a été remis.

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 de module 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é, à annuler la remise du devoir demandé ou en cas d'erreurs d'accès.
  • FAILED_PRECONDITION si le devoir de l'élève n'a pas été remis.
  • INVALID_ARGUMENT si la requête est mal formée.
  • NOT_FOUND si le cours, le travail de cours ou le devoir de l'élève demandé n'existe pas.

Requête HTTP

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

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.
courseWorkId

string

Identifiant du travail de cours.
id

string

Identifiant du devoir de l'é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.me

Pour en savoir plus, consultez le guide sur l'autorisation.