Method: courses.courseWork.rubrics.patch

• Solicitud HTTP
• Parámetros de ruta de acceso
• Parámetros de consulta
• Cuerpo de la solicitud
• Cuerpo de la respuesta
• Alcances de autorización
• Pruébalo

Actualiza una rúbrica.

Consulta google.classroom.v1.Rubric para obtener detalles sobre qué campos se pueden actualizar. Las capacidades de actualización de la rúbrica son limitadas una vez que comienza la calificación.

El usuario solicitante y el propietario del curso deben tener capacidades de creación de rúbricas. Para obtener más información, consulta los requisitos de licencias.

La consola de Google Cloud debe realizar esta solicitud del ID de cliente de OAuth que se usó para crear el elemento de trabajo del curso superior.

Este método muestra los siguientes códigos de error:

• PERMISSION_DENIED si el proyecto del desarrollador solicitante no creó la tarea del curso correspondiente, si el usuario no tiene permiso para realizar la modificación solicitada en la rúbrica o por errores de acceso. Este código de error también se muestra si ya se comenzó a calificar en la rúbrica.
• INVALID_ARGUMENT si la solicitud tiene un formato incorrecto y por el siguiente error de solicitud:
  • RubricCriteriaInvalidFormat
• NOT_FOUND si el curso, la tarea o la rúbrica solicitados no existen, o si el usuario no tiene acceso a la tarea correspondiente.
• INTERNAL si ya se comenzó a calificar en la rúbrica.

Solicitud HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
courseId	string Obligatorio. Es el identificador del curso.
courseWorkId	string Obligatorio. Es el identificador del trabajo del curso.
id	string Opcional. Es el identificador de la rúbrica.

Parámetros de consulta

Parámetros
updateMask	string (FieldMask format) Opcional. Es una máscara que identifica qué campos de la rúbrica se deben actualizar. Este campo es obligatorio para realizar una actualización. La actualización fallará si se especifican campos no válidos. Existen varias opciones para definir los criterios de una rúbrica: sourceSpreadsheetId y la lista criteria. Solo se puede usar uno de estos a la vez para definir una rúbrica. La lista criteria de la rúbrica se reemplaza por completo por los criterios de la rúbrica especificados en la solicitud de actualización. Por ejemplo, si falta un criterio o nivel en la solicitud, se borra. Se agregan criterios y niveles nuevos, y se asigna un ID. Los criterios y niveles existentes retienen el ID asignado anteriormente si se especifica en la solicitud. Los profesores pueden especificar los siguientes campos: criteria sourceSpreadsheetId Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
previewVersion	enum (PreviewVersion) Opcional. La versión preliminar de la API. Se debe configurar para acceder a las nuevas funciones de la API que se ponen a disposición de los desarrolladores en el programa de versión preliminar.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Rubric.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Rubric.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

• https://www.googleapis.com/auth/classroom.coursework.students
Importante: Para crear una rúbrica desde una hoja de cálculo de Google especificando sourceSpreadsheetId, se requieren permisos adicionales: https://www.googleapis.com/auth/spreadsheets.readonly o https://www.googleapis.com/auth/spreadsheets. Ten en cuenta que los permisos spreadsheets se consideran sensibles y es posible que debas verificar tu aplicación.

Para obtener más información, consulta la Guía de autorización.