Referencia de tools¶

34 tools: 21 de lectura y 13 de escritura. Los clientes las descubren con tools/list. No se listan las tools desactivadas, las de escritura mientras la escritura esté apagada ni las de un alcance que el usuario o el token no pueden usar. Los errores dentro de una tool vuelven como error de tool con un mensaje corto (por ejemplo Course not found.).

Lectura · General¶

Tool	Permiso de Moodle
`site_info`	—
`search_courses`	Visibilidad del curso para el usuario
`get_course_structure`	Acceso al curso
`list_participants`	`moodle/course:viewparticipants`
`list_activities`	Acceso al curso
`get_grades_summary`	`moodle/grade:view`; `moodle/grade:viewall` para medias y otros usuarios; las notas ocultas requieren `moodle/grade:viewhidden`
`get_task_status`	Solo el usuario que encoló la tarea o un administrador del sitio

Lectura · Estudiante¶

Tool	Permiso de Moodle
`get_my_deadlines`	Eventos de acción del calendario de ese usuario; visibilidad de la actividad
`get_my_grades`	`moodle/grade:view` en cada curso
`get_my_progress`	Acceso al curso
`get_assignment_details`	`mod/assign:view`
`get_forum_posts`	`mod/forum:viewdiscussion`
`get_calendar_events`	Visibilidad del calendario
`search_course_content`	Solo actividades visibles

Lectura · Profesor¶

Tool	Permiso de Moodle
`get_submissions_status`	`mod/assign:grade` (`moodle/site:accessallgroups` para ver todos los grupos)
`get_ungraded_work`	`mod/assign:grade`, `mod/quiz:grade`
`get_quiz_results`	`mod/quiz:viewreports`
`get_inactive_students`	`moodle/course:viewparticipants` y `report/outline:view`
`get_activity_completion_report`	`report/progress:view`
`get_course_logs_summary`	`report/log:view`
`get_forum_unanswered`	`mod/forum:viewdiscussion`

Escritura¶

Tool	Permiso de Moodle
`create_course`	`moodle/course:create` en la categoría
`build_course`	Curso nuevo: `moodle/course:create` en la categoría
`add_section`	`moodle/course:update`
`add_activity`	`moodle/course:manageactivities` y `mod/<tipo>:addinstance`
`create_quiz`	`moodle/course:manageactivities` y `mod/quiz:addinstance`
`add_quiz_questions`	`mod/quiz:manage` y `moodle/question:add` (`moodle/question:managecategory` para crear una categoría)
`import_questions`	`moodle/question:add` (`mod/quiz:manage` para añadirlas a un cuestionario)
`update_activity`	La comprobación normal de Moodle para editar actividades (`moodle/course:manageactivities`); `moodle/course:activityvisibility` para cambiar `visible`
`enrol_user`	`enrol/manual:enrol`
`create_group`	`moodle/course:managegroups`
`set_visibility`	`moodle/course:visibility`, `moodle/course:sectionvisibility` o `moodle/course:activityvisibility`, según el objetivo
`delete_activity`	`moodle/course:manageactivities`
`delete_section`	`moodle/course:update`