Method: courses.announcements.getAddOnContext

Obtient les métadonnées des modules complémentaires Classroom dans le contexte d'une publication spécifique.

Pour préserver l'intégrité de ses propres données et modèles d'autorisations, un module complémentaire doit appeler cette méthode pour valider les paramètres de requête et le rôle de l'utilisateur à l'origine de la demande chaque fois qu'il est ouvert dans un iFrame.

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

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnContext

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 l'annonce, courseWork ou courseWorkMaterial sous lesquels la pièce jointe est jointe. Ce champ est obligatoire, mais il n'est pas marqué comme tel pendant la migration depuis postId.

Paramètres de requête

Paramètres
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.

Le jeton d'autorisation est requis si aucune des conditions suivantes n'est vraie:

  • Le module complémentaire comporte des pièces jointes au post.
  • Le projet de développement émettant la requête est le même projet que celui qui a créé la publication.

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 contient une instance de AddOnContext.

Champs d'application des autorisations

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

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

Pour en savoir plus, consultez le guide relatif aux autorisations.