Method: courses.posts.addOnAttachments.studentSubmissions.patch

Met à jour les données associées à l'envoi d'une pièce jointe de module complémentaire.

Nécessite que le module complémentaire ait été le créateur d'origine de l'attachement et que la valeur maxPoints de l'attachement soit définie sur une valeur positive.

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

  • PERMISSION_DENIED pour les erreurs d'accès.
  • INVALID_ARGUMENT si la requête est incorrecte.
  • NOT_FOUND si l'une des ressources identifiées n'existe pas.

Requête HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Obligatoire. Identifiant du cours.
postId
(deprecated)

string

Facultatif. Obsolète, utilisez plutôt itemId.
attachmentId

string

Obligatoire. Identifiant de la pièce jointe.
submissionId

string

Obligatoire. Identifiant du devoir envoyé par l'élève.

Paramètres de requête

Paramètres
itemId

string

Identifiant de l'Announcement, de l'CourseWork ou de l'CourseWorkMaterial auquel l'élément joint est associé. Ce champ est obligatoire, mais n'est pas marqué comme tel pendant la migration depuis postId.
updateMask

string (FieldMask format)

Obligatoire. Masque qui identifie les champs de la pièce jointe à mettre à jour. La mise à jour échoue si des champs non valides sont spécifiés. Si un champ accepte des valeurs vides, vous pouvez le supprimer en le spécifiant dans le masque de mise à jour et non dans l'objet AddOnAttachmentStudentSubmission.

Les enseignants peuvent spécifier les champs suivants:

  • pointsEarned

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"

Corps de la requête

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

Corps de la réponse

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/classroom.addons.teacher

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