Api-roll 44: 2017-01-23

discovery/googleapis/classroom__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/classroom.course-work.readonly": {
                     "description": "View instructions for teacher-assigned work in your Google Classroom classes"
                 },
                 "https://www.googleapis.com/auth/classroom.courses": {
                     "description": "Manage your Google Classroom classes"
                 },
@@ skipping 32 matching lines @@
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://classroom.googleapis.com/",
     "batchPath": "batch",
     "description": "Manages classes, rosters, and invitations in Google Classroom.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/classroom/",
-    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/mk_oLjlaBwJ1BcBJ5yykCFb6u3w\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/VPjAdAuQhi94i4H_5Zyjop6mRoc\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "classroom:v1",
     "kind": "discovery#restDescription",
     "name": "classroom",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 609 matching lines @@
                                 "https://www.googleapis.com/auth/classroom.profile.photos",
                                 "https://www.googleapis.com/auth/classroom.rosters",
                                 "https://www.googleapis.com/auth/classroom.rosters.readonly"
                             ]
                         }
                     }
                 },
                 "courseWork": {
                     "methods": {
                         "create": {
-                            "description": "Creates course work. The resulting course work (and corresponding student submissions) are associated with the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to make the request. Classroom API requests to modify course work and student submissions must be made with an OAuth client ID from the associated Developer Console project. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course, create course work in the requested course, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist.",
+                            "description": "Creates course work. The resulting course work (and corresponding student submissions) are associated with the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to make the request. Classroom API requests to modify course work and student submissions must be made with an OAuth client ID from the associated Developer Console project. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course, create course work in the requested course, share a Drive attachment, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course does not exist. * `FAILED_PRECONDITION` for the following request error: * AttachmentNotVisible",
                             "httpMethod": "POST",
                             "id": "classroom.courses.courseWork.create",
                             "parameterOrder": [
                                 "courseId"
                             ],
                             "parameters": {
                                 "courseId": {
                                     "description": "Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/courses/{courseId}/courseWork",
                             "request": {
                                 "$ref": "CourseWork"
                             },
                             "response": {
                                 "$ref": "CourseWork"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/classroom.coursework.students"
                             ]
                         },
+                        "patch": {
+                            "description": "Updates one or more fields of a course work. See google.classroom.v1.CourseWork for details of which fields may be updated and who may change them. This request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting developer project did not create the corresponding course work, if the user is not permitted to make the requested modification to the student submission, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `FAILED_PRECONDITION` if the requested course work has already been deleted. * `NOT_FOUND` if the requested course, course work, or student submission does not exist.",
+                            "httpMethod": "PATCH",
+                            "id": "classroom.courses.courseWork.patch",
+                            "parameterOrder": [
+                                "courseId",
+                                "id"
+                            ],
+                            "parameters": {
+                                "courseId": {
+                                    "description": "Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "id": {
+                                    "description": "Identifier of the course work.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "updateMask": {
+                                    "description": "Mask that identifies which fields on the course work to update. This field is required to do an update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the CourseWork object. If a field that does not support empty values is included in the update mask and not set in the CourseWork object, an `INVALID_ARGUMENT` error will be returned. The following fields may be specified by teachers: * `title` * `description` * `state` * `due_date` * `due_time` * `max_points` * `submission_modification_mode`",
+                                    "location": "query",
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/courses/{courseId}/courseWork/{id}",
+                            "request": {
+                                "$ref": "CourseWork"
+                            },
+                            "response": {
+                                "$ref": "CourseWork"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/classroom.coursework.students"
+                            ]
+                        },
+                        "delete": {
+                            "description": "Deletes a course work. This request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting developer project did not create the corresponding course work, if the requesting user is not permitted to delete the requested course or for access errors. * `FAILED_PRECONDITION` if the requested course work has already been deleted. * `NOT_FOUND` if no course exists with the requested ID.",
+                            "httpMethod": "DELETE",
+                            "id": "classroom.courses.courseWork.delete",
+                            "parameterOrder": [
+                                "courseId",
+                                "id"
+                            ],
+                            "parameters": {
+                                "courseId": {
+                                    "description": "Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "id": {
+                                    "description": "Identifier of the course work to delete. This identifier is a Classroom-assigned identifier.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/courses/{courseId}/courseWork/{id}",
+                            "response": {
+                                "$ref": "Empty"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/classroom.coursework.students"
+                            ]
+                        },
                         "get": {
                             "description": "Returns course work. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course or course work does not exist.",
                             "httpMethod": "GET",
                             "id": "classroom.courses.courseWork.get",
                             "parameterOrder": [
                                 "courseId",
                                 "id"
                             ],
                             "parameters": {
                                 "courseId": {
@@ skipping 277 matching lines @@
                                         "$ref": "TurnInStudentSubmissionRequest"
                                     },
                                     "response": {
                                         "$ref": "Empty"
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/classroom.coursework.me"
                                     ]
                                 },
                                 "reclaim": {
-                                    "description": "Reclaims a student submission on behalf of the student that owns it. Reclaiming a student submission transfers ownership of attached Drive files to the student and update the submission state. Only the student that ownes the requested student submission may call this method, and only for a student submission that has been turned in. This request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, unsubmit the requested student submission, or for access errors. * `FAILED_PRECONDITION` if the student submission has not been turned in. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course, course work, or student submission does not exist.",
+                                    "description": "Reclaims a student submission on behalf of the student that owns it. Reclaiming a student submission transfers ownership of attached Drive files to the student and update the submission state. Only the student that owns the requested student submission may call this method, and only for a student submission that has been turned in. This request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, unsubmit the requested student submission, or for access errors. * `FAILED_PRECONDITION` if the student submission has not been turned in. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course, course work, or student submission does not exist.",
                                     "httpMethod": "POST",
                                     "id": "classroom.courses.courseWork.studentSubmissions.reclaim",
                                     "parameterOrder": [
                                         "courseId",
                                         "courseWorkId",
                                         "id"
                                     ],
                                     "parameters": {
                                         "courseId": {
                                             "description": "Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.",
@@ skipping 59 matching lines @@
                                         "$ref": "ReturnStudentSubmissionRequest"
                                     },
                                     "response": {
                                         "$ref": "Empty"
                                     },
                                     "scopes": [
                                         "https://www.googleapis.com/auth/classroom.coursework.students"
                                     ]
                                 },
                                 "modifyAttachments": {
-                                    "description": "Modifies attachments of student submission. Attachments may only be added to student submissions whose type is `ASSIGNMENT`. This request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, if the user is not permitted to modify attachments on the requested student submission, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course, course work, or student submission does not exist.",
+                                    "description": "Modifies attachments of student submission. Attachments may only be added to student submissions belonging to course work objects with a `workType` of `ASSIGNMENT`. This request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access the requested course or course work, if the user is not permitted to modify attachments on the requested student submission, or for access errors. * `INVALID_ARGUMENT` if the request is malformed. * `NOT_FOUND` if the requested course, course work, or student submission does not exist.",
                                     "httpMethod": "POST",
                                     "id": "classroom.courses.courseWork.studentSubmissions.modifyAttachments",
                                     "parameterOrder": [
                                         "courseId",
                                         "courseWorkId",
                                         "id"
                                     ],
                                     "parameters": {
                                         "courseId": {
                                             "description": "Identifier of the course. This identifier can be either the Classroom-assigned identifier or an alias.",
@@ skipping 28 matching lines @@
                                 }
                             }
                         }
                     }
                 }
             }
         },
         "userProfiles": {
             "methods": {
                 "get": {
-                    "description": "Returns a user profile. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access this user profile or if no profile exists with the requested ID or for access errors.",
+                    "description": "Returns a user profile. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to access this user profile, if no profile exists with the requested ID, or for access errors.",
                     "httpMethod": "GET",
                     "id": "classroom.userProfiles.get",
                     "parameterOrder": [
                         "userId"
                     ],
                     "parameters": {
                         "userId": {
                             "description": "Identifier of the profile to return. The identifier can be one of the following: * the numeric identifier for the user * the email address of the user * the string literal `\"me\"`, indicating the requesting user",
                             "location": "path",
                             "required": true,
@@ skipping 181 matching lines @@
                                     "location": "query",
                                     "type": "integer"
                                 }
                             },
                             "path": "v1/userProfiles/{studentId}/guardians",
                             "response": {
                                 "$ref": "ListGuardiansResponse"
                             }
                         },
                         "get": {
-                            "description": "Returns a specific guardian. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to view guardian information for the student identified by the `student_id`, if guardians are not enabled for the domain in question, or for other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be recognized (it is not an email address, nor a `student_id` from the API, nor the literal string `me`). * `NOT_FOUND` if Classroom cannot find any record of the given student or `guardian_id`, or if the guardian has been disabled.",
+                            "description": "Returns a specific guardian. This method returns the following error codes: * `PERMISSION_DENIED` if no user that matches the provided `student_id` is visible to the requesting user, if the requesting user is not permitted to view guardian information for the student identified by the `student_id`, if guardians are not enabled for the domain in question, or for other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be recognized (it is not an email address, nor a `student_id` from the API, nor the literal string `me`). * `NOT_FOUND` if the requesting user is permitted to view guardians for the requested `student_id`, but no `Guardian` record exists for that student that matches the provided `guardian_id`.",
                             "httpMethod": "GET",
                             "id": "classroom.userProfiles.guardians.get",
                             "parameterOrder": [
                                 "studentId",
                                 "guardianId"
                             ],
                             "parameters": {
                                 "studentId": {
                                     "description": "The student whose guardian is being requested. One of the following: * the numeric identifier for the user * the email address of the user * the string literal `\"me\"`, indicating the requesting user",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "guardianId": {
                                     "description": "The `id` field from a `Guardian`.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 }
                             },
                             "path": "v1/userProfiles/{studentId}/guardians/{guardianId}",
                             "response": {
                                 "$ref": "Guardian"
                             }
                         },
                         "delete": {
-                            "description": "Deletes a guardian. The guardian will no longer receive guardian notifications and the guardian will no longer be accessible via the API. This method returns the following error codes: * `PERMISSION_DENIED` if the requesting user is not permitted to manage guardians for the student identified by the `student_id`, if guardians are not enabled for the domain in question, or for other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be recognized (it is not an email address, nor a `student_id` from the API). * `NOT_FOUND` if Classroom cannot find any record of the given `student_id` or `guardian_id`, or if the guardian has already been disabled.",
+                            "description": "Deletes a guardian. The guardian will no longer receive guardian notifications and the guardian will no longer be accessible via the API. This method returns the following error codes: * `PERMISSION_DENIED` if no user that matches the provided `student_id` is visible to the requesting user, if the requesting user is not permitted to manage guardians for the student identified by the `student_id`, if guardians are not enabled for the domain in question, or for other access errors. * `INVALID_ARGUMENT` if a `student_id` is specified, but its format cannot be recognized (it is not an email address, nor a `student_id` from the API). * `NOT_FOUND` if the requesting user is permitted to modify guardians for the requested `student_id`, but no `Guardian` record exists for that student with the provided `guardian_id`.",
                             "httpMethod": "DELETE",
                             "id": "classroom.userProfiles.guardians.delete",
                             "parameterOrder": [
                                 "studentId",
                                 "guardianId"
                             ],
                             "parameters": {
                                 "studentId": {
                                     "description": "The student whose guardian is to be deleted. One of the following: * the numeric identifier for the user * the email address of the user * the string literal `\"me\"`, indicating the requesting user",
                                     "location": "path",
@@ skipping 135 matching lines @@
                     "response": {
                         "$ref": "Empty"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/classroom.rosters"
                     ]
                 }
             }
         }
     },
-    "revision": "20161006",
+    "revision": "20170110",
     "rootUrl": "https://classroom.googleapis.com/",
     "schemas": {
         "Course": {
             "description": "A Course in Classroom.",
             "id": "Course",
             "properties": {
                 "id": {
                     "description": "Identifier for this course assigned by Classroom. When creating a course, you may optionally set this identifier to an alias string in the request to create a corresponding alias. The `id` is still assigned by Classroom and cannot be updated after the course is created. Specifying this field in a course update mask results in an error.",
                     "type": "string"
                 },
@@ skipping 317 matching lines @@
                     ],
                     "type": "string"
                 },
                 "creationTime": {
                     "description": "The time that this invitation was created. Read-only.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
-        "ListGuardiansResponse": {
-            "description": "Response when listing guardians.",
-            "id": "ListGuardiansResponse",
-            "properties": {
-                "guardians": {
-                    "description": "Guardians on this page of results that met the criteria specified in the request.",
-                    "items": {
-                        "$ref": "Guardian"
-                    },
-                    "type": "array"
-                },
-                "nextPageToken": {
-                    "description": "Token identifying the next page of results to return. If empty, no further results are available.",
-                    "type": "string"
-                }
-            },
-            "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",
-            "properties": {
-                "studentId": {
-                    "description": "Identifier for the student to whom the guardian relationship applies.",
-                    "type": "string"
-                },
-                "guardianId": {
-                    "description": "Identifier for the guardian.",
-                    "type": "string"
-                },
-                "guardianProfile": {
-                    "$ref": "UserProfile",
-                    "description": "User profile for the guardian."
-                },
-                "invitedEmailAddress": {
-                    "description": "The email address to which the initial guardian invitation was sent. This field is only visible to domain administrators.",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
         "UserProfile": {
             "description": "Global information for a user.",
             "id": "UserProfile",
             "properties": {
                 "id": {
                     "description": "Identifier of the user. Read-only.",
                     "type": "string"
                 },
                 "name": {
                     "$ref": "Name",
@@ skipping 122 matching lines @@
                     },
                     "type": "array"
                 },
                 "nextPageToken": {
                     "description": "Token identifying the next page of results to return. If empty, no further results are available.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
+        "ListGuardiansResponse": {
+            "description": "Response when listing guardians.",
+            "id": "ListGuardiansResponse",
+            "properties": {
+                "guardians": {
+                    "description": "Guardians on this page of results that met the criteria specified in the request.",
+                    "items": {
+                        "$ref": "Guardian"
+                    },
+                    "type": "array"
+                },
+                "nextPageToken": {
+                    "description": "Token identifying the next page of results to return. If empty, no further results are available.",
+                    "type": "string"
+                }
+            },
+            "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",
+            "properties": {
+                "studentId": {
+                    "description": "Identifier for the student to whom the guardian relationship applies.",
+                    "type": "string"
+                },
+                "guardianId": {
+                    "description": "Identifier for the guardian.",
+                    "type": "string"
+                },
+                "guardianProfile": {
+                    "$ref": "UserProfile",
+                    "description": "User profile for the guardian."
+                },
+                "invitedEmailAddress": {
+                    "description": "The email address to which the initial guardian invitation was sent. This field is only visible to domain administrators.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Invitation": {
             "description": "An invitation to join a course.",
             "id": "Invitation",
             "properties": {
                 "id": {
                     "description": "Identifier assigned by Classroom. Read-only.",
                     "type": "string"
                 },
                 "userId": {
                     "description": "Identifier of the invited user. When specified as a parameter of a request, this identifier can be set to one of the following: * the numeric identifier for the user * the email address of the user * the string literal `\"me\"`, indicating the requesting user",
@@ skipping 89 matching lines @@
                 "dueTime": {
                     "$ref": "TimeOfDay",
                     "description": "Optional time of day, in UTC, that submissions for this this course work are due. This must be specified if `due_date` is specified."
                 },
                 "maxPoints": {
                     "description": "Maximum grade for this course work. If zero or unspecified, this assignment is considered ungraded. This must be a non-negative integer value.",
                     "format": "double",
                     "type": "number"
                 },
                 "workType": {
-                    "description": "Type of this course work. The type is set when the course work is created and cannot be changed. When creating course work, this must be `ASSIGNMENT`.",
+                    "description": "Type of this course work. The type is set when the course work is created and cannot be changed.",
                     "enum": [
                         "COURSE_WORK_TYPE_UNSPECIFIED",
                         "ASSIGNMENT",
                         "SHORT_ANSWER_QUESTION",
                         "MULTIPLE_CHOICE_QUESTION"
                     ],
                     "type": "string"
                 },
                 "associatedWithDeveloper": {
                     "description": "Whether this course work item is associated with the Developer Console project making the request. See google.classroom.Work.CreateCourseWork for more details. Read-only.",
                     "type": "boolean"
                 },
                 "submissionModificationMode": {
                     "description": "Setting to determine when students are allowed to modify submissions. If unspecified, the default value is `MODIFIABLE_UNTIL_TURNED_IN`.",
                     "enum": [
                         "SUBMISSION_MODIFICATION_MODE_UNSPECIFIED",
                         "MODIFIABLE_UNTIL_TURNED_IN",
                         "MODIFIABLE"
                     ],
                     "type": "string"
                 },
                 "assignment": {
                     "$ref": "Assignment",
-                    "description": "Assignment details. This is populated only when `work_type` is `ASSIGNMENT`."
+                    "description": "Assignment details. This is populated only when `work_type` is `ASSIGNMENT`. Read-only."
                 },
                 "multipleChoiceQuestion": {
                     "$ref": "MultipleChoiceQuestion",
-                    "description": "Multiple choice question details. This is populated only when `work_type` is `MULTIPLE_CHOICE_QUESTION`."
+                    "description": "Multiple choice question details. For read operations, this field is populated only when `work_type` is `MULTIPLE_CHOICE_QUESTION`. For write operations, this field must be specified when creating course work with a `work_type` of `MULTIPLE_CHOICE_QUESTION`, and it must not be set otherwise."
                 }
             },
             "type": "object"
         },
         "Material": {
-            "description": "Material attached to course work. When creating attachments, only the Link field may be specified.",
+            "description": "Material attached to course work. When creating attachments, setting the `form` field is not supported.",
             "id": "Material",
             "properties": {
                 "driveFile": {
                     "$ref": "SharedDriveFile",
                     "description": "Google Drive file material."
                 },
                 "youtubeVideo": {
                     "$ref": "YouTubeVideo",
                     "description": "YouTube video material."
                 },
                 "link": {
                     "$ref": "Link",
-                    "description": "Link material."
+                    "description": "Link material. On creation, will be upgraded to a more appropriate type if possible, and this will be reflected in the response."
                 },
                 "form": {
                     "$ref": "Form",
                     "description": "Google Forms material."
                 }
             },
             "type": "object"
         },
         "SharedDriveFile": {
             "description": "Drive file that is used as material for course work.",
@@ skipping 193 matching lines @@
                     "description": "Submission content when course_work_type is MULTIPLE_CHOICE_QUESTION."
                 }
             },
             "type": "object"
         },
         "AssignmentSubmission": {
             "description": "Student work for an assignment.",
             "id": "AssignmentSubmission",
             "properties": {
                 "attachments": {
-                    "description": "Attachments added by the student. Drive files that correspond to materials with a share mode of SUBMISSION_COPY may not exist yet if the student has not accessed the assignment in Classroom. Some attachment metadata is only populated if the requesting user has permission to access it. Identifier and alternate_link fields are available, but others (e.g. title) may not be.",
+                    "description": "Attachments added by the student. Drive files that correspond to materials with a share mode of STUDENT_COPY may not exist yet if the student has not accessed the assignment in Classroom. Some attachment metadata is only populated if the requesting user has permission to access it. Identifier and alternate_link fields are always available, but others (e.g. title) may not be.",
                     "items": {
                         "$ref": "Attachment"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "Attachment": {
-            "description": "Attachment added to student assignment work. When creating attachments, only the Link field may be specified.",
+            "description": "Attachment added to student assignment work. When creating attachments, setting the `form` field is not supported.",
             "id": "Attachment",
             "properties": {
                 "driveFile": {
                     "$ref": "DriveFile",
                     "description": "Google Drive file attachment."
                 },
                 "youTubeVideo": {
                     "$ref": "YouTubeVideo",
                     "description": "Youtube video attachment."
                 },
@@ skipping 61 matching lines @@
         "ReturnStudentSubmissionRequest": {
             "description": "Request to return a student submission.",
             "id": "ReturnStudentSubmissionRequest",
             "type": "object"
         },
         "ModifyAttachmentsRequest": {
             "description": "Request to modify the attachments of a student submission.",
             "id": "ModifyAttachmentsRequest",
             "properties": {
                 "addAttachments": {
-                    "description": "Attachments to add. A student submission may not have more than 20 attachments. This may only contain link attachments.",
+                    "description": "Attachments to add. A student submission may not have more than 20 attachments. Form attachments are not supported.",
                     "items": {
                         "$ref": "Attachment"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "Google Classroom API",
     "version": "v1"
 }