En esta guía, se explica cómo crear archivos adjuntos de complementos en tu sitio web o aplicación. Las interacciones son similares a crear tareas con los extremos de la API de CourseWork. Implementa este recorrido para permitir que los usuarios creen archivos adjuntos de complementos desde tu sitio web o aplicación.
Flujo de trabajo
En términos generales, el proceso de creación de adjuntos sigue esta secuencia:
- Un usuario profesor abre tu sitio web o app y selecciona un contenido para asignarlo a sus estudiantes.
- Verifica que el usuario pueda crear archivos adjuntos de complementos.
- Si el usuario no puede crear archivos adjuntos de complementos, crea una asignación CourseWork con la URL al contenido seleccionado como material de vínculo.
- Si el usuario puede crear archivos adjuntos de complementos, haz lo siguiente:
- Crea una tarea.
- Crea un archivo adjunto de complemento que se vincule al contenido seleccionado y asócialo con la tarea nueva.
- Infórmale al profesor que la tarea se creó correctamente.
Cada acción se describe en las siguientes secciones.
Verifica si un usuario puede crear archivos adjuntos de complementos
Puedes crear archivos adjuntos de complementos en nombre de un usuario que cumpla con los requisitos. Un usuario apto es un usuario que es profesor del curso en el que intentas crear tareas del curso y que tiene asignada la licencia de la edición de Google Workspace for Education de Teaching & Learning o Education Plus.
Primero, determina si el usuario puede crear complementos en un Course
determinado.
Emite una solicitud al extremo courses.checkAddOnCreationEligibility
, incluido el ID del curso.
Python
eligibility_response = (
classroom_service.courses()
.checkAddOnCreationEligibility(courseId=course_id)
.execute()
)
is_create_attachment_eligible = (
eligibility_response.get('isCreateAttachmentEligible')
)
print(f'User eligibility for course {eligibility_response.get("courseId")}'
f': {is_create_attachment_eligible}.')
Si el usuario es apto, la respuesta contiene el valor booleano isCreateAttachmentEligible
establecido en true
. Si el usuario no es apto, la respuesta no mostrará el valor booleano isCreateAttachmentEligible
.
Redireccionar al usuario según su elegibilidad
La elegibilidad determina si puede crear archivos adjuntos de complementos para un usuario.
Usuario no apto
Si el usuario no puede crear archivos adjuntos de complementos, crea una nueva asignación de CourseWork
con la URL de contenido que seleccionó el usuario como Link
.
Python
if not is_create_attachment_eligible:
coursework = {
'title': 'My CourseWork Assignment with Link Material',
'description': 'Created using the Classroom CourseWork API.',
'workType': 'ASSIGNMENT',
'state': 'DRAFT', # Set to 'PUBLISHED' to assign to students.
'maxPoints': 100,
'materials': [
{'link': {'url': my_content_url}}
]
}
assignment = (
service.courses()
.courseWork()
.create(courseId=course_id, body=coursework)
.execute()
)
print(
f'Link Material assignment created with ID: {assignment.get("id")}'
)
La respuesta contiene una tarea del curso solicitado con el contenido adjunto. Los usuarios pueden hacer clic en Link
para abrir el contenido de tu sitio en una pestaña nueva.
Figura 1: Vista del profesor de un borrador de una tarea de CourseWork con Link Material.
Usuario apto
Haz lo siguiente si el usuario puede crear archivos adjuntos de complementos.
- Crea una nueva tarea de
CourseWork
sin archivos adjuntos. - Crea un archivo adjunto del complemento.
- Establece el
itemId
deAddOnAttachment
en elid
de la asignación recién creada. - Asegúrate de proporcionar URLs al contenido seleccionado por el usuario para cada vista que admitas.
- Establece el
Python
if is_create_attachment_eligible:
coursework = {
'title': 'My CourseWork Assignment with Add-on Attachment',
'description': 'Created using the Classroom CourseWork API.',
'workType': 'ASSIGNMENT',
'state': 'DRAFT', # Set to 'PUBLISHED' to assign to students.
'maxPoints': 100,
}
assignment = (
classroom_service.courses()
.courseWork()
.create(courseId=course_id, body=coursework)
.execute()
)
print(
f'Empty assignment created with ID: {assignment.get("id")}'
)
attachment = {
'teacherViewUri': {'uri': teacher_view_url},
'studentViewUri': {'uri': student_view_url},
'studentWorkReviewUri': {'uri': grade_student_work_url},
'title': f'Test Attachment {test_label}',
}
add_on_attachment = (
service.courses()
.courseWork()
.addOnAttachments()
.create(
courseId=course_id,
itemId=assignment.get("id"), # ID of the new assignment.
body=attachment,
)
.execute()
)
print(
f'Add-on attachment created with ID: {add_on_attachment.get("id")}'
)
El complemento aparece como una tarjeta de archivo adjunto en Classroom. Las URLs especificadas en la solicitud se abren en el iframe para cada vista adecuado.