Method: courses.announcements.list

Affiche la liste des annonces que le demandeur est autorisé à consulter.

Les élèves du cours ne peuvent voir que les annonces PUBLISHED. Les enseignants du cours et les administrateurs du domaine peuvent consulter toutes les annonces.

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

  • PERMISSION_DENIED si l'utilisateur à l'origine de la requête n'est pas autorisé à accéder au cours demandé ou en cas d'erreurs d'accès.
  • INVALID_ARGUMENT si la requête est incorrecte.
  • NOT_FOUND si le cours demandé n'existe pas.

Requête HTTP

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

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.

Paramètres de requête

Paramètres
announcementStates[]

enum (AnnouncementState)

Restriction sur le state des annonces renvoyées. Si cet argument n'est pas spécifié, la valeur par défaut est PUBLISHED.

orderBy

string

Ordre de tri facultatif pour les résultats. Liste de champs séparés par une virgule avec un mot clé de tri facultatif. Le champ accepté est updateTime. Les mots clés de direction acceptés sont asc et desc. Si aucune valeur n'est spécifiée, updateTime desc est le comportement par défaut. Exemples: updateTime asc, updateTime

pageSize

integer

Nombre maximal d'éléments à renvoyer. Une valeur nulle ou non spécifiée indique que le serveur peut attribuer une valeur maximale.

Le serveur peut renvoyer un nombre inférieur au nombre de résultats spécifié.

pageToken

string

Valeur nextPageToken renvoyée par un appel list précédent, indiquant que la page de résultats suivante doit être renvoyée.

La requête list doit être identique à celle qui a généré ce jeton.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse lors de la liste des travaux de cours.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "announcements": [
    {
      object (Announcement)
    }
  ],
  "nextPageToken": string
}
Champs
announcements[]

object (Announcement)

Éléments d'annonce correspondant à la requête.

nextPageToken

string

Jeton identifiant la page de résultats suivante à renvoyer. Si ce champ est vide, aucun autre résultat n'est disponible.

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/classroom.announcements
  • https://www.googleapis.com/auth/classroom.announcements.readonly

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