Google Classroom

google_classroom

Google Classroom is a free web service developed by Google for schools that aims to simplify creating, distributing, and grading assignments

Education Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (31)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

List CourseWorkMaterialsGOOGLE_CLASSROOM_CLASSROOMS_COURSE_WORK_MATERIALS_LISTAcción

Tool to list courseworkmaterials in a course. use after confirming a valid courseid; supports pagination and ordering.

Parámetros de entrada

orderBystringenum
Requested sorting order. Supported values: 'updateTime asc', 'updateTime desc'.
updateTime ascupdateTime desc
courseIdstringObligatorio
Identifier of the course whose courseWorkMaterials should be returned.
pageSizeinteger
Maximum number of items to return. Must be between 1 and 100. Defaults to 30.
pageTokenstring
Token identifying which page of results to return.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create AnnouncementGOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_CREATEAcción

Tool to create an announcement in a course. use after confirming the course id is valid.

Parámetros de entrada

textstring
The text content of the announcement.
statestringenum
State of the announcement; if omitted defaults to PUBLISHED.
DRAFTPUBLISHEDDELETED
courseIdstringObligatorio
Identifier of the course.
materialsobject[]
List of materials to attach to the announcement.
assigneeModestringenum
Mode for assigning the announcement; ALL_STUDENTS or INDIVIDUAL_STUDENTS.
ALL_STUDENTSINDIVIDUAL_STUDENTS
scheduledTimestring
RFC3339 timestamp at which to publish the announcement.
individualStudentsOptionsobject
Options for INDIVIDUAL_STUDENTS assignee mode.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete AnnouncementGOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_DELETEAcción

Tool to delete an announcement. use after confirming the announcement id.

Parámetros de entrada

idstringObligatorio
Identifier of the announcement to delete.
courseIdstringObligatorio
Identifier of the course.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get AnnouncementGOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_GETAcción

Tool to get an announcement. use when you need to fetch an announcement by course and announcement id.

Parámetros de entrada

idstringObligatorio
Identifier of the announcement to retrieve.
courseIdstringObligatorio
Identifier of the course. This identifier can be either the Classroom-assigned ID or an alias.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List AnnouncementsGOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_LISTAcción

Tool to list announcements in a course. use after you have the course id to page through announcements.

Parámetros de entrada

orderBystringenum
How to sort announcements. Use `updateTime desc` (newest first) or `updateTime asc` (oldest first). Defaults to `updateTime desc`.
updateTime ascupdateTime desc
courseIdstringObligatorio
Identifier of the course whose announcements should be listed. Can be the Classroom-assigned identifier or an alias.
pageSizeinteger
Maximum number of announcements to return. Must be between 1 and 100. Defaults to 30 if not set.
pageTokenstring
Token specifying the next page of results to return. Obtain from a previous list call's `nextPageToken`.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Patch AnnouncementGOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_PATCHAcción

Tool to update fields of an announcement. use when you need to modify specific details of an existing announcement after confirming which fields to update.

Parámetros de entrada

idstringObligatorio
Identifier of the announcement to update.
textstring
The text content of the announcement to set.
statestringenum
State of the announcement.
DRAFTPUBLISHEDDELETED
courseIdstringObligatorio
Identifier of the course.
materialsobject[]
List of materials to attach to the announcement.
updateMaskstringObligatorio
Comma-separated list of fields to update. E.g., 'text,state'.
assigneeModestringenum
Mode for assigning the announcement; ALL_STUDENTS or INDIVIDUAL_STUDENTS.
ALL_STUDENTSINDIVIDUAL_STUDENTS
scheduledTimestring
RFC3339 timestamp at which to publish the announcement.
individualStudentsOptionsobject
Options for INDIVIDUAL_STUDENTS assignee mode.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create CourseGOOGLE_CLASSROOM_COURSES_CREATEAcción

Tool to create a new course. use when a teacher needs to establish a classroom course before enrollment.

Parámetros de entrada

namestringObligatorio
Name of the course. Max length 750 characters.
roomstring
Room location for the course. Max length 64 characters.
ownerIdstringObligatorio
Identifier of the course owner. Can be the user's numeric ID or email address.
sectionstring
Section of the course. Max length 2800 characters.
courseStatestringenum
Initial state of the course.
COURSE_STATE_UNSPECIFIEDACTIVEARCHIVEDPROVISIONEDDECLINEDSUSPENDED
descriptionstring
Detailed description of the course. Max length 30,000 characters.
descriptionHeadingstring
Heading for the course description. Max length 360 characters.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete CourseGOOGLE_CLASSROOM_COURSES_DELETEAcción

Tool to delete a course. use when you need to remove a course after confirming the course id.

Parámetros de entrada

idstringObligatorio
Identifier of the course to delete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get CourseGOOGLE_CLASSROOM_COURSES_GETAcción

Tool to get details for a specific course. use when you need full course information by id.

Parámetros de entrada

idstringObligatorio
Identifier of the course. This identifier can be either the Classroom-assigned ID or an alias.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CoursesGOOGLE_CLASSROOM_COURSES_LISTAcción

Tool to list all courses accessible to the authenticated user. use when you need a paginated list of courses.

Parámetros de entrada

pageSizeinteger
Maximum number of items to return. Must be ≥1.
pageTokenstring
Token identifying the page of results to return.
studentIdstring
Restricts returned courses to those in which the student is enrolled. Can be the user's numeric ID or 'me'.
teacherIdstring
Restricts returned courses to those taught by the teacher. Can be the user's numeric ID or 'me'.
courseStatesstring[]
Restricts returned courses to those in specified states.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Patch CourseGOOGLE_CLASSROOM_COURSES_PATCHAcción

Tool to update one or more fields of a classroom course. use after retrieving course details and confirming fields to update.

Parámetros de entrada

idstringObligatorio
Identifier of the course to update.
namestring
New name of the course.
roomstring
New room/location for the course.
ownerIdstring
New owner user ID for the course.
sectionstring
New section of the course.
updateMaskstringObligatorio
Comma-separated list of fields to update. E.g., 'name,section'.
courseStatestringenum
New state of the course.
COURSE_STATE_UNSPECIFIEDACTIVEARCHIVEDPROVISIONEDDECLINED
descriptionstring
New detailed description of the course.
descriptionHeadingstring
New heading for the course description.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Student GuardiansGOOGLE_CLASSROOM_COURSES_STUDENTS_GUARDIANS_LISTAcción

Tool to list guardians of a student in a course. use when you need to retrieve and paginate guardians for a given student in a course.

Parámetros de entrada

courseIdstringObligatorio
Identifier of the course. Can be the Classroom-assigned ID or an alias.
pageSizeinteger
Maximum number of guardians to return. Must be between 1 and 100. Defaults to server's default.
pageTokenstring
Token identifying which page of results to return.
studentIdstringObligatorio
Identifier of the student (the user's id or email address, or 'me').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Course StudentsGOOGLE_CLASSROOM_COURSES_STUDENTS_LISTAcción

Tool to list students in a course. use after you have the course id to page through enrolled students.

Parámetros de entrada

courseIdstringObligatorio
Identifier of the course whose students should be listed. Can be the Classroom-assigned identifier or an alias.
pageSizeinteger
Maximum number of students to return. Must be between 1 and 100.
pageTokenstring
Token specifying which page of results to return. Obtain from a previous list call's `nextPageToken`.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TeacherGOOGLE_CLASSROOM_COURSES_TEACHERS_GETAcción

Tool to get teacher enrollment. use when you need to retrieve a specific teacher in a course by courseid and userid.

Parámetros de entrada

fieldsstring
Selector specifying which fields to include in a partial response.
userIdstringObligatorio
Identifier of the teacher to retrieve. Can be the teacher's numeric user ID or email address.
courseIdstringObligatorio
Identifier of the course. This identifier can be either the Classroom-assigned ID or an alias.
quotaUserstring
Arbitrary string assigned to a user for quota purposes (server-side applications only).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Course TeachersGOOGLE_CLASSROOM_COURSES_TEACHERS_LISTAcción

Tool to list teachers in a course. use after you have the course id to page through enrolled teachers.

Parámetros de entrada

courseIdstringObligatorio
Identifier of the course whose teachers should be listed.
pageSizeinteger
Maximum number of teachers to return. Must be between 1 and 100.
pageTokenstring
Token specifying which page of results to return.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Course TopicGOOGLE_CLASSROOM_COURSES_TOPICS_CREATEAcción

Tool to create a course topic. use when you need to organize course content into named sections.

Parámetros de entrada

namestringObligatorio
Name of the topic.
courseIdstringObligatorio
Identifier of the course to create the topic in.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Course TopicGOOGLE_CLASSROOM_COURSES_TOPICS_DELETEAcción

Tool to delete a course topic. use when you need to remove a topic from a course after confirming the course and topic ids.

Parámetros de entrada

idstringObligatorio
Identifier of the topic to delete.
courseIdstringObligatorio
Identifier of the course.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Course TopicGOOGLE_CLASSROOM_COURSES_TOPICS_GETAcción

Tool to get a course topic. use when you need to retrieve details of a specific course topic by id after confirming the course and topic ids.

Parámetros de entrada

idstringObligatorio
Identifier of the topic to retrieve.
courseIdstringObligatorio
Identifier of the course. This can be the Classroom-assigned identifier or an alias.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Course TopicsGOOGLE_CLASSROOM_COURSES_TOPICS_LISTAcción

Tool to list topics in a course. use when you have confirmed the courseid and need to retrieve its topics.

Parámetros de entrada

courseIdstringObligatorio
Identifier of the course (Classroom-assigned ID or alias).
pageSizeinteger
Maximum number of topics to return; zero means no limit.
pageTokenstring
Token identifying which page of results to return.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Patch Course TopicGOOGLE_CLASSROOM_COURSES_TOPICS_PATCHAcción

Tool to update fields of a course topic. use when you need to rename a topic after confirming its current details.

Parámetros de entrada

idstringObligatorio
Identifier of the topic.
namestring
New display name of the topic.
courseIdstringObligatorio
Identifier of the course.
updateMaskstring
Comma-separated list of fields to update. Currently only 'name' supported.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create CourseWorkGOOGLE_CLASSROOM_COURSE_WORK_CREATEAcción

Tool to create a coursework item in a course. use when you need to assign an assignment or question to students immediately or on a schedule.

Parámetros de entrada

statestringenum
Whether to save as draft or publish immediately
DRAFTPUBLISHED
titlestringObligatorio
Title of the coursework
dueDateobject
Date portion of coursework due date (year, month, day).
dueTimeobject
Time portion of coursework due time (hours, minutes, seconds, nanos).
topicIdstring
Topic ID to organize coursework under
courseIdstringObligatorio
Identifier of the course
workTypestringObligatorioenum
Type of coursework being created
ASSIGNMENTSHORT_ANSWER_QUESTIONMULTIPLE_CHOICE_QUESTION
materialsobject[]
Materials to attach to the coursework
maxPointsnumber
Maximum points available for the coursework
assignmentobject
Assignment details if workType is ASSIGNMENT
descriptionstring
Detailed description or instructions
scheduledTimestring
RFC3339 timestamp to auto-publish the coursework
shortAnswerQuestionobject
Details for short-answer question.
multipleChoiceQuestionobject
Details for multiple-choice question.
submissionModificationModestringenum
Controls if students can edit submissions after turn-in
SUBMISSION_MODIFICATION_MODE_UNSPECIFIEDMODIFIABLE_UNTIL_TURNED_INMODIFIABLE

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete CourseWorkGOOGLE_CLASSROOM_COURSE_WORK_DELETEAcción

Tool to delete a specific coursework. use when you need to remove a coursework item from a course after confirming the ids.

Parámetros de entrada

idstringObligatorio
Identifier of the coursework item to delete.
courseIdstringObligatorio
Identifier of the course.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get CourseWorkGOOGLE_CLASSROOM_COURSE_WORK_GETAcción

Tool to get details of a specific coursework. use when detailed information about a particular assignment is needed.

Parámetros de entrada

idstringObligatorio
Identifier of the coursework item to retrieve.
courseIdstringObligatorio
Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CourseWorkGOOGLE_CLASSROOM_COURSE_WORK_LISTAcción

Tool to list coursework in a course. use after verifying courseid.

Parámetros de entrada

orderBystring
Sort ordering for results. Comma-separated list of fields with optional direction. Supported fields: 'updateTime', 'dueDate'. Supported direction keywords: 'asc', 'desc'. Default: 'updateTime desc'.
courseIdstringObligatorio
Identifier of the course (Classroom-assigned ID or alias).
pageSizeinteger
Maximum number of items to return. Zero or unspecified indicates the server may assign a maximum. The server may return fewer than the specified number.
pageTokenstring
NextPageToken from a previous list call, indicating subsequent page of results to return. Must be used with otherwise identical request.
previewVersionstring
Preview version of the API. Set to access new capabilities in the Preview Program.
courseWorkStatesstring[]
Restriction on the coursework state to return. Only coursework matching one of these states is returned. If unspecified, defaults to ['PUBLISHED'].

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Course Work MaterialGOOGLE_CLASSROOM_COURSE_WORK_MATERIALS_CREATEAcción

Tool to create course work material. use when adding resources or notes to a course.

Parámetros de entrada

statestringObligatorioenum
DRAFTPUBLISHEDDELETED
titlestring
Title of the course work material.
topicIdstring
Identifier of the topic to which this material belongs.
courseIdstringObligatorio
Identifier of the course.
materialsobject[]
Materials attached to the course work material. Each element defines one of driveFile, link, form, or youtubeVideo.
descriptionstring
Description of the course work material.
assigneeModestringenum
Who can see the material. Defaults to ALL_STUDENTS.
ALL_STUDENTSINDIVIDUAL_STUDENTS
scheduledTimestring
RFC3339 formatted time when the material is scheduled to be published, e.g., '2020-10-28T16:01:23Z'.
associatedWithDeveloperboolean
Whether this material is associated with a developer project.
individualStudentsOptionsobject
Options for INDIVIDUAL_STUDENTS assignee mode.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Coursework MaterialGOOGLE_CLASSROOM_COURSE_WORK_MATERIALS_GETAcción

Tool to get a coursework material. use when you need to retrieve details of a specific coursework material by course and material id.

Parámetros de entrada

idstringObligatorio
Identifier of the coursework material.
courseIdstringObligatorio
Identifier of the course. Can be Classroom-assigned identifier or an alias.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CourseWorkMaterialsGOOGLE_CLASSROOM_COURSE_WORK_MATERIALS_LISTAcción

Tool to list course work materials in a course. use when you need to retrieve and paginate materials for a given courseid.

Parámetros de entrada

orderBystringenum
Optional sorting order; allowed values are 'updateTime asc' or 'updateTime desc'.
updateTime ascupdateTime desc
courseIdstringObligatorio
Identifier of the course whose courseWorkMaterials should be returned.
pageSizeinteger
Maximum number of items to return. Must be between 1 and 100. Defaults to 30.
pageTokenstring
Token identifying which page of results to return.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Patch CourseworkGOOGLE_CLASSROOM_COURSE_WORK_PATCHAcción

Tool to update fields of a coursework. use when you need to modify specific details of an existing coursework after confirming which fields to update.

Parámetros de entrada

idstringObligatorio
Identifier of the CourseWork to update.
titlestring
Title of the coursework to set.
dueDateobject
Model for due date.
dueTimeobject
Model for due time.
topicIdstring
Topic ID to assign.
courseIdstringObligatorio
Identifier of the course. Can be the Classroom-assigned identifier or an alias.
workTypestringenum
Type of the coursework.
COURSE_WORK_TYPE_UNSPECIFIEDASSIGNMENTSHORT_ANSWER_QUESTIONMULTIPLE_CHOICE_QUESTION
maxPointsnumber
Maximum grade points for the coursework.
updateMaskstringObligatorio
Comma-separated list of fields to update. E.g., 'title,description'.
descriptionstring
Description of the coursework to set.
scheduledTimestring
Timestamp in RFC3339 format to set for scheduledTime.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Student SubmissionsGOOGLE_CLASSROOM_COURSE_WORK_STUDENT_SUBMISSIONS_LISTAcción

Tool to list student submissions for a specific coursework. use when you need to fetch or paginate student submissions by course and coursework, optionally filtering by user, state, or timeliness.

Parámetros de entrada

latestringenum
Filters returned submissions to those that are on time or late.
LATE_ONLYNOT_LATE_ONLY
statesstring[]
Filters returned submissions to those in the specified states.
userIdstring
Restricts returned submissions to those owned by the specified user. Use numeric ID or 'me'.
courseIdstringObligatorio
Identifier of the course.
pageSizeinteger
Maximum number of items to return. Defaults to 30; maximum is 100.
pageTokenstring
Token for next page of results.
courseWorkIdstringObligatorio
Identifier of the coursework; use '-' to return submissions for all coursework in the course.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Reclaim Student SubmissionGOOGLE_CLASSROOM_COURSE_WORK_STUDENT_SUBMISSIONS_RECLAIMAcción

Tool to reclaim a student submission for editing. use after a student requests to edit their turned-in submission, resetting its state to created.

Parámetros de entrada

idstringObligatorio
Identifier of the student submission.
courseIdstringObligatorio
Identifier of the course.
courseWorkIdstringObligatorio
Identifier of the coursework.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create InvitationGOOGLE_CLASSROOM_INVITATIONS_CREATEAcción

Tool to create an invitation for a user to a course. use after confirming the course id is valid.

Parámetros de entrada

rolestringObligatorioenum
Role to invite the user as.
STUDENTTEACHER
userIdstringObligatorio
Identifier of the user to invite. Can be the user's numeric ID or email address.
courseIdstringObligatorio
Identifier of the course to invite the user to.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not