REST Resource: courses.announcements.addOnAttachments

Ressource: AddOnAttachment

Une pièce jointe de module complémentaire à un post.

Représentation JSON
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "id": string,
  "title": string,
  "teacherViewUri": {
    object (EmbedUri)
  },
  "studentViewUri": {
    object (EmbedUri)
  },
  "studentWorkReviewUri": {
    object (EmbedUri)
  },
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "maxPoints": number,
  "copyHistory": [
    {
      object (CopyHistory)
    }
  ]
}
Champs
courseId

string

Immuable. Identifiant du cours.

postId
(deprecated)

string

Immuable. Obsolète. Utilisez plutôt itemId.

itemId

string

Immuable. Identifiant de l'annonce, du cours CourseWork ou du CourseWorkMaterial auquel la pièce jointe est jointe. Unique pour chaque cours.

id

string

Immuable. Identifiant attribué par Classroom à cette pièce jointe, unique pour chaque post.

title

string

Obligatoire. Titre de cette pièce jointe. Le titre doit comporter entre 1 et 1 000 caractères.

teacherViewUri

object (EmbedUri)

Obligatoire. URI permettant d'afficher la pièce jointe dans la vue enseignant L'URI sera ouverte dans un iFrame avec les paramètres de requête courseId, postId et attachmentId définis.

studentViewUri

object (EmbedUri)

Obligatoire. URI permettant d'afficher la pièce jointe dans la vue élève L'URI sera ouverte dans un iFrame avec les paramètres de requête courseId, postId et attachmentId définis.

studentWorkReviewUri

object (EmbedUri)

URI permettant à l'enseignant de voir le travail des élèves sur la pièce jointe, le cas échéant. L'URI sera ouvert dans un iFrame avec les paramètres de requête courseId, postId, attachmentId et submissionId. Il s'agit du même submissionId renvoyé par [google.classroom.AddOns.GetAddOnContext][announcements.getAddOnContext] lorsqu'un élève affiche la pièce jointe. Si l'URI est omis ou supprimé, maxPoints sera également supprimé.

dueDate

object (Date)

Date (en UTC) à laquelle doit s'appliquer cette pièce jointe. Ce champ doit être spécifié si dueTime est spécifié.

dueTime

object (TimeOfDay)

Heure de la journée (UTC) à laquelle la pièce jointe doit être envoyée. Ce champ doit être spécifié si dueDate est spécifié.

maxPoints

number

Note maximale pour cette pièce jointe. Ne peut être défini que si studentWorkReviewUri est défini. Définissez une valeur non nulle pour indiquer que la pièce jointe accepte le renvoi de notes. S'il est défini, il doit s'agir d'un nombre entier non négatif. Si la valeur est définie sur zéro, la pièce jointe ne permet pas le renvoi des notes.

copyHistory[]

object (CopyHistory)

Uniquement en sortie. Identifiants des pièces jointes qui étaient des copies précédentes de cette pièce jointe.

Si la pièce jointe a déjà été copiée alors que son post parent a été copié, les identifiants des pièces jointes qui étaient ses copies précédentes sont énumérés dans l'ordre chronologique croissant de la copie.

EmbedUri

URI à placer dans un cadre iFrame après avoir été renseigné avec les paramètres de requête.

Représentation JSON
{
  "uri": string
}
Champs
uri

string

Obligatoire. URI à placer dans un cadre iFrame après avoir été renseigné avec les paramètres de requête. Il doit s'agir d'une chaîne UTF-8 valide contenant entre 1 et 1 800 caractères.

CopyHistory

Identifiant d'une copie précédente d'une pièce jointe donnée.

Représentation JSON
{
  "courseId": string,
  "postId": string,
  "itemId": string,
  "attachmentId": string
}
Champs
courseId

string

Immuable. Identifiant du cours.

postId
(deprecated)

string

Immuable. Obsolète. Utilisez plutôt itemId.

itemId

string

Immuable. Identifiant de l'annonce, du cours CourseWork ou du CourseWorkMaterial auquel la pièce jointe est jointe.

attachmentId

string

Immuable. Identifiant du rattachement.

Méthodes

create

Crée une pièce jointe de module complémentaire sous un post.

delete

Supprime une pièce jointe de module complémentaire.

get

Renvoie une pièce jointe de module complémentaire.

list

Renvoie toutes les pièces jointes créées par un module complémentaire sous le post.

patch

Met à jour une pièce jointe de module complémentaire.