- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Affiche une liste des annonces que le demandeur est autorisé à consulter.
Les étudiants du cours ne peuvent voir que les annonces PUBLISHED
. Les enseignants du cours et les administrateurs de domaine peuvent voir toutes les annonces.
Cette méthode renvoie les codes d'erreur suivants:
PERMISSION_DENIED
si l'utilisateur à l'origine de la demande n'est pas autorisé à accéder au cours demandé ou en cas d'erreurs d'accès.INVALID_ARGUMENT
si le format de la requête est incorrect.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 |
Identifiant du cours. Il peut s'agir de l'identifiant attribué par Classroom ou d'un |
Paramètres de requête
Paramètres | |
---|---|
announcementStates[] |
Restriction appliquée au |
orderBy |
Ordre de tri facultatif pour les résultats. Liste de champs séparés par une virgule avec un mot clé dans l'ordre de tri facultatif. Champ accepté : |
pageSize |
Nombre maximal d'éléments à renvoyer. La valeur "zéro" ou "non spécifié" indique que le serveur peut attribuer une valeur maximale. Le serveur peut renvoyer un nombre de résultats inférieur au nombre spécifié. |
pageToken |
Valeur Par ailleurs, la requête |
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 devoirs.
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 ( |
Champs | |
---|---|
announcements[] |
Annonces correspondant à la demande. |
nextPageToken |
Jeton identifiant la page suivante de résultats à renvoyer. Si ce champ n'est pas renseigné, 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 relatif aux autorisations.