Method: courses.announcements.addOnAttachments.create

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

Le module complémentaire doit être autorisé à créer des pièces jointes dans le post.

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

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

Requête HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
courseId

string

Obligatoire. Identifiant du cours.
itemId

string

Identifiant de Announcement, CourseWork ou CourseWorkMaterial sous lequel créer le rattachement. Ce champ est obligatoire, mais n'est pas marqué comme tel lors de la migration depuis postId.

Paramètres de requête

Paramètres
postId
(deprecated)

string

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

string

Facultatif. Jeton qui autorise la requête.

Le jeton est transmis en tant que paramètre de requête lorsque l'utilisateur est redirigé depuis Classroom vers l'URL du module complémentaire.

Ce jeton d'autorisation est obligatoire pour créer des pièces jointes dans Classroom, mais facultatif pour la création de pièces jointes axées sur les partenaires. Renvoie une erreur s'il n'est pas fourni pour la création de rattachements avec priorité par le partenaire, et si les projets de développement qui ont créé le rattachement et l'élément de flux parent ne correspondent pas.

Corps de la requête

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

Corps de la réponse

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

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 relatif aux autorisations.