- Recurso: Curso
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- Métodos
Recurso: Curso
Un curso en Classroom.
Representación JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Campos | |
---|---|
id |
Es el identificador de este curso asignado por Classroom. Cuando es Si especificas este campo en una máscara de actualización del curso, se mostrará un error. |
name |
Es el nombre del curso. Por ejemplo, "Biología de 10o grado". El nombre es obligatorio. Debe tener entre 1 y 750 caracteres y una string UTF-8 válida. |
section |
Sección del curso. Por ejemplo, "Período 2". Si se configura, este campo debe ser una string UTF-8 válida y no debe tener más de 2,800 caracteres. |
descriptionHeading |
Encabezado opcional para la descripción. Por ejemplo, "Te damos la bienvenida a Biología de 10o grado". Si se configura, este campo debe ser una string UTF-8 válida y no puede tener más de 3,600 caracteres. |
description |
Descripción opcional. Por ejemplo, "Aprenderemos sobre la estructura de los seres vivos a partir de una combinación de libros de texto, conferencias invitadas y trabajos de laboratorio. Debes tener entusiasmo". Si se configura, este campo debe ser una string UTF-8 válida y no debe tener más de 30,000 caracteres. |
room |
Ubicación opcional de la sala de reuniones. Por ejemplo, “301”. Si se configura, este campo debe ser una string UTF-8 válida y no debe tener más de 650 caracteres. |
ownerId |
Es el identificador del propietario de un curso. Cuando se especifica como parámetro de una
Esto se debe configurar en una solicitud de creación. Los administradores también pueden especificar este campo en un |
creationTime |
Hora de creación del curso. Si especificas este campo en una máscara de actualización del curso, se mostrará un error. Solo lectura. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
updateTime |
Hora de la actualización más reciente de este curso. Si especificas este campo en una máscara de actualización del curso, se mostrará un error. Solo lectura. Una marca de tiempo en formato RFC3339 UTC "Zulú", con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
enrollmentCode |
Código de inscripción que se usará cuando te unas a este curso. Si especificas este campo en una máscara de actualización del curso, se mostrará un error. Solo lectura. |
courseState |
Estado del curso Si no se especifica, el estado predeterminado es |
alternateLink |
Vínculo absoluto a este curso en la IU web de Classroom. Solo lectura. |
teacherGroupEmail |
Es la dirección de correo electrónico de un Grupo de Google que contenga todos los profesores del curso. Este grupo no acepta correos electrónicos y solo se puede usar para obtener permisos. Solo lectura. |
courseGroupEmail |
Es la dirección de correo electrónico de un Grupo de Google que contiene todos los miembros del curso. Este grupo no acepta correos electrónicos y solo se puede usar para obtener permisos. Solo lectura. |
teacherFolder |
Información sobre una carpeta de Drive que se comparte con todos los profesores del curso Este campo solo se establecerá para los profesores del curso y los administradores del dominio. Solo lectura. |
courseMaterialSets[] |
Conjuntos de materiales que aparecen en la página “Acerca de” de este curso. Solo lectura. |
guardiansEnabled |
Indica si las notificaciones a los tutores están habilitadas o no para este curso. Solo lectura. |
calendarId |
El ID de calendario de un calendario que pueden ver todos los miembros del curso, al que Classroom agrega eventos para el trabajo del curso y los anuncios del curso. El calendario de un curso se crea de forma asíncrona cuando el curso se configura como Solo lectura. |
gradebookSettings |
La configuración del libro de calificaciones que especifica cómo se calculará la calificación general de un alumno para el curso y a quiénes se mostrará. Solo lectura |
CourseState
Estados posibles en los que puede estar un curso.
Enumeradores | |
---|---|
COURSE_STATE_UNSPECIFIED |
Sin estado del curso. Ningún mensaje del curso que se muestre usará este valor. |
ACTIVE |
El curso está activo. |
ARCHIVED |
Se archivó el curso. No puedes modificarlo, excepto para cambiarlo a un estado diferente. |
PROVISIONED |
Se creó el curso, pero todavía no se activó. El profesor principal y los administradores del dominio pueden acceder a él, quienes pueden modificarlo o cambiarlo a los estados ACTIVE o DECLINED . Un curso solo se puede cambiar a PROVISIONED si tiene el estado DECLINED . |
DECLINED |
Se creó el curso, pero se rechazó. El propietario del curso y los administradores del dominio pueden acceder a él, aunque no se mostrará en la IU web. No puedes modificar el curso, excepto cambiarlo al estado PROVISIONED . Un curso solo se puede cambiar a DECLINED si tiene el estado PROVISIONED . |
SUSPENDED |
Se suspendió el curso. No puedes modificar el curso, y solo el usuario identificado por ownerId podrá verlo. Se puede colocar un curso en este estado si potencialmente infringe las Condiciones del Servicio. |
CourseMaterialSet
Un conjunto de materiales que aparece en la página “Acerca de” del curso. Estos materiales pueden incluir un plan de estudios, un cronograma u otra información de contexto relacionada con el curso en su totalidad.
Representación JSON |
---|
{
"title": string,
"materials": [
{
object ( |
Campos | |
---|---|
title |
Es el título de este conjunto. |
materials[] |
Materiales adjuntos a este conjunto. |
CourseMaterial
Es un material adjunto a un curso como parte de un conjunto de materiales.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión material . Datos de Material. Las direcciones (material ) solo pueden ser una de las siguientes opciones: |
|
driveFile |
Archivo adjunto de Google Drive. |
youTubeVideo |
Video adjunto de YouTube. |
link |
Ataque de vínculo. |
form |
Archivo adjunto de Formularios de Google. |
GradebookSettings
La configuración del libro de calificaciones de un curso Para obtener más información, consulte el artículo del Centro de ayuda.
Representación JSON |
---|
{ "calculationType": enum ( |
Campos | |
---|---|
calculationType |
Indica cómo se calcula la calificación general. |
displaySetting |
Indica quién puede ver la calificación general. |
gradeCategories[] |
Categorías de calificación disponibles para los trabajos de curso del curso. |
CalculationType
Posibles métodos para el cálculo general de las calificaciones.
Enumeradores | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
No se especificó ningún método. Este nunca se muestra. |
TOTAL_POINTS |
La calificación general es la suma de las calificaciones dividida por la suma del total de puntos, sin importar la categoría. |
WEIGHTED_CATEGORIES |
La calificación general es el promedio ponderado por categoría. |
DisplaySetting
Posibles opciones de configuración para mostrar la calificación general.
Enumeradores | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
No se especificó ningún parámetro de configuración. Este nunca se muestra. |
SHOW_OVERALL_GRADE |
Muestra tanto a los profesores como a los alumnos la calificación general en el libro de calificaciones y en el perfil del alumno. |
HIDE_OVERALL_GRADE |
No muestra la calificación general en el libro de calificaciones ni en el perfil del alumno. |
SHOW_TEACHERS_ONLY |
Muestra la calificación general a los profesores en el libro de calificaciones y el perfil del alumno. Se oculta a los estudiantes en su perfil de estudiante. |
Métodos |
|
---|---|
|
Muestra si un usuario es apto para crear archivos adjuntos de complementos en un curso determinado. |
|
Crea un curso. |
|
Borra un curso. |
|
Muestra un curso. |
|
Muestra una lista de cursos que el usuario solicitante puede ver, restringida a aquellos que coinciden con la solicitud. |
|
Actualiza uno o más campos de un curso. |
|
Actualiza un curso. |