- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Muestra una lista de anuncios que el solicitante tiene permitido ver.
Los estudiantes del curso solo pueden ver los anuncios de PUBLISHED
. Los profesores de cursos y los administradores del dominio pueden ver todos los anuncios.
Este método muestra los siguientes códigos de error:
PERMISSION_DENIED
si el usuario que realiza la solicitud no tiene permiso para acceder al curso solicitado o por errores de acceso.- Es
INVALID_ARGUMENT
si la solicitud tiene un formato incorrecto. NOT_FOUND
si el curso solicitado no existe.
Solicitud HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
courseId |
Es el identificador del curso. Este identificador puede ser el que asignó Classroom o un |
Parámetros de consulta
Parámetros | |
---|---|
announcementStates[] |
Se aplicaron restricciones sobre el |
orderBy |
Orden de clasificación opcional para los resultados. Una lista de campos separados por comas con una palabra clave opcional de dirección de ordenamiento. El campo admitido es |
pageSize |
Cantidad máxima de artículos que se devolverán. Cero o no especificado indica que el servidor puede asignar un máximo. Es posible que el servidor muestre menos resultados que la cantidad especificada. |
pageToken |
Es el valor La solicitud |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Respuesta cuando se enumera el trabajo del curso.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"announcements": [
{
object ( |
Campos | |
---|---|
announcements[] |
Elementos de anuncio que coinciden con la solicitud. |
nextPageToken |
Token que identifica la siguiente página de resultados que se mostrarán. Si este campo está vacío, no habrá más resultados disponibles. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/classroom.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
Para obtener más información, consulta la guía de autorización.