Method: courses.courseWork.studentSubmissions.modifyAttachments

Modifie les pièces jointes des devoirs des élèves.

Vous ne pouvez ajouter des pièces jointes qu'aux devoirs des élèves appartenant à des objets de travail de cours dont la valeur workType est ASSIGNMENT.

Cette requête doit être effectuée par le projet de la console du développeur de l'ID client OAuth utilisé pour créer l'élément de travail du cours correspondant.

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 ou au travail demandé, s'il n'est pas autorisé à modifier les pièces jointes du devoir demandé ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est incorrecte.
  • NOT_FOUND si le cours, le travail de cours ou le devoir de l'élève demandés n'existent pas.

Requête HTTP

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

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 devoir.
id

string

Identifiant du devoir de l'élève.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
Champs
addAttachments[]

object (Attachment)

Pièces jointes à ajouter. Un devoir ne peut pas comporter plus de 20 pièces jointes.

Les pièces jointes Form ne sont pas acceptées.
previewVersion

enum (PreviewVersion)

Facultatif. Version preview de l'API. 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 réponse

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

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

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