Update all json files; make some fixes to make it work at all

This commit is contained in:
Sebastian Thiel
2022-03-08 07:59:31 +08:00
parent d12cd3238e
commit 743a56f4b7
372 changed files with 256017 additions and 32197 deletions

View File

@@ -170,7 +170,7 @@
"courses": {
"methods": {
"create": {
"description": "Creates a course. The user specified in `ownerId` is the owner of the created course and added as a teacher. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create courses or for access errors. * `NOT_FOUND` if the primary teacher is not a valid user. * `FAILED_PRECONDITION` if the course owner's account is disabled or for the following request errors: * UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if an alias was specified in the `id` and already exists.",
"description": "Creates a course. The user specified in `ownerId` is the owner of the created course and added as a teacher. A non-admin requesting user can only create a course with themselves as the owner. Domain admins can create courses owned by any user within their domain. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create courses or for access errors. * `NOT_FOUND` if the primary teacher is not a valid user. * `FAILED_PRECONDITION` if the course owner's account is disabled or for the following request errors: * UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if an alias was specified in the `id` and already exists.",
"flatPath": "v1/courses",
"httpMethod": "POST",
"id": "classroom.courses.create",
@@ -1471,7 +1471,7 @@
"students": {
"methods": {
"create": {
"description": "Adds a user as a student of a course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create students in this course or for access errors. * `NOT_FOUND` if the requested course ID does not exist. * `FAILED_PRECONDITION` if the requested user's account is disabled, for the following request errors: * CourseMemberLimitReached * CourseNotModifiable * UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if the user is already a student or teacher in the course.",
"description": "Adds a user as a student of a course. Domain administrators are permitted to [directly add](https://developers.google.com/classroom/guides/manage-users) users within their domain as students to courses within their domain. Students are permitted to add themselves to a course using an enrollment code. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create students in this course or for access errors. * `NOT_FOUND` if the requested course ID does not exist. * `FAILED_PRECONDITION` if the requested user's account is disabled, for the following request errors: * CourseMemberLimitReached * CourseNotModifiable * UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if the user is already a student or teacher in the course.",
"flatPath": "v1/courses/{courseId}/students",
"httpMethod": "POST",
"id": "classroom.courses.students.create",
@@ -1612,7 +1612,7 @@
"teachers": {
"methods": {
"create": {
"description": "Creates a teacher of a course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create teachers in this course or for access errors. * `NOT_FOUND` if the requested course ID does not exist. * `FAILED_PRECONDITION` if the requested user's account is disabled, for the following request errors: * CourseMemberLimitReached * CourseNotModifiable * CourseTeacherLimitReached * UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if the user is already a teacher or student in the course.",
"description": "Creates a teacher of a course. Domain administrators are permitted to [directly add](https://developers.google.com/classroom/guides/manage-users) users within their domain as teachers to courses within their domain. Non-admin users should send an Invitation instead. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to create teachers in this course or for access errors. * `NOT_FOUND` if the requested course ID does not exist. * `FAILED_PRECONDITION` if the requested user's account is disabled, for the following request errors: * CourseMemberLimitReached * CourseNotModifiable * CourseTeacherLimitReached * UserGroupsMembershipLimitReached * `ALREADY_EXISTS` if the user is already a teacher or student in the course.",
"flatPath": "v1/courses/{courseId}/teachers",
"httpMethod": "POST",
"id": "classroom.courses.teachers.create",
@@ -1641,7 +1641,7 @@
]
},
"delete": {
"description": "Deletes a teacher of a course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to delete teachers of this course or for access errors. * `NOT_FOUND` if no teacher of this course has the requested ID or if the course does not exist. * `FAILED_PRECONDITION` if the requested ID belongs to the primary teacher of this course.",
"description": "Removes the specified teacher from the specified course. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to delete teachers of this course or for access errors. * `NOT_FOUND` if no teacher of this course has the requested ID or if the course does not exist. * `FAILED_PRECONDITION` if the requested ID belongs to the primary teacher of this course. * `FAILED_PRECONDITION` if the requested ID belongs to the owner of the course Drive folder. * `FAILED_PRECONDITION` if the course no longer has an active owner.",
"flatPath": "v1/courses/{courseId}/teachers/{userId}",
"httpMethod": "DELETE",
"id": "classroom.courses.teachers.delete",
@@ -2400,7 +2400,7 @@
}
}
},
"revision": "20210323",
"revision": "20220224",
"rootUrl": "https://classroom.googleapis.com/",
"schemas": {
"Announcement": {
@@ -2605,6 +2605,10 @@
"description": "Enrollment code to use when joining this course. Specifying this field in a course update mask results in an error. Read-only.",
"type": "string"
},
"gradebookSettings": {
"$ref": "GradebookSettings",
"description": "The gradebook settings that specify how a student's overall grade for the course will be calculated and who it will be displayed to. Read-only"
},
"guardiansEnabled": {
"description": "Whether or not guardian notifications are enabled for this course. Read-only.",
"type": "boolean"
@@ -2763,6 +2767,10 @@
"$ref": "TimeOfDay",
"description": "Optional time of day, in UTC, that submissions for this course work are due. This must be specified if `due_date` is specified."
},
"gradeCategory": {
"$ref": "GradeCategory",
"description": "The category that this coursework's grade contributes to. Present only when a category has been chosen for the coursework. May be used in calculating the overall grade. Read-only."
},
"id": {
"description": "Classroom-assigned identifier of this course work, unique per course. Read-only.",
"type": "string"
@@ -2957,7 +2965,7 @@
"type": "object"
},
"Date": {
"description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`.",
"description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values * A month and day, with a zero year (e.g., an anniversary) * A year on its own, with a zero month and a zero day * A year and month, with a zero day (e.g., a credit card expiration date) Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp",
"id": "Date",
"properties": {
"day": {
@@ -3099,6 +3107,31 @@
},
"type": "object"
},
"GradeCategory": {
"description": "Details for a grade category in a course. Coursework may have zero or one grade category, and the category may be used in computing the overall grade. See the [help center article](https://support.google.com/edu/classroom/answer/9184995) for details.",
"id": "GradeCategory",
"properties": {
"defaultGradeDenominator": {
"description": "Default value of denominator. Only applicable when grade calculation type is TOTAL_POINTS.",
"format": "int32",
"type": "integer"
},
"id": {
"description": "ID of the grade category.",
"type": "string"
},
"name": {
"description": "Name of the grade category.",
"type": "string"
},
"weight": {
"description": "The weight of the category average as part of overall average. A weight of 12.34% is represented as 123400 (100% is 1,000,000). The last two digits should always be zero since we use two decimal precision. Only applicable when grade calculation type is WEIGHTED_CATEGORIES.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"GradeHistory": {
"description": "The history of each grade on this submission.",
"id": "GradeHistory",
@@ -3141,6 +3174,50 @@
},
"type": "object"
},
"GradebookSettings": {
"description": "The gradebook settings for a course. See the [help center article](https://support.google.com/edu/classroom/answer/9184995) for details.",
"id": "GradebookSettings",
"properties": {
"calculationType": {
"description": "Indicates how the overall grade is calculated.",
"enum": [
"CALCULATION_TYPE_UNSPECIFIED",
"TOTAL_POINTS",
"WEIGHTED_CATEGORIES"
],
"enumDescriptions": [
"No method specified. This is never returned.",
"Overall grade is the sum of grades divided by the sum of total points regardless of category.",
"Overall grade is the weighted average by category."
],
"type": "string"
},
"displaySetting": {
"description": "Indicates who can see the overall grade..",
"enum": [
"DISPLAY_SETTING_UNSPECIFIED",
"SHOW_OVERALL_GRADE",
"HIDE_OVERALL_GRADE",
"SHOW_TEACHERS_ONLY"
],
"enumDescriptions": [
"No setting specified. This is never returned.",
"Shows overall grade in the gradebook and student profile to both teachers and students.",
"Does not show overall grade in the gradebook or student profile.",
"Shows the overall grade to teachers in the gradebook and student profile. Hides from students in their student profile."
],
"type": "string"
},
"gradeCategories": {
"description": "Grade categories that are available for coursework in the course.",
"items": {
"$ref": "GradeCategory"
},
"type": "array"
}
},
"type": "object"
},
"Guardian": {
"description": "Association between a student and a guardian of that student. The guardian may receive information about the student's course work.",
"id": "Guardian",