Api-Roll 53: 2017-08-21

generated/googleapis/lib/classroom/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.classroom.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 226 matching lines @@
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Course.fromJson(data));
   }
 
   /**
    * Returns a list of courses that the requesting user is permitted to view,
-   * restricted to those that match the request.
+   * restricted to those that match the request. Returned courses are ordered by
+   * creation time, with the most recently created coming first.
    *
    * This method returns the following error codes:
    *
    * * `PERMISSION_DENIED` for access errors.
    * * `INVALID_ARGUMENT` if the query argument is malformed.
    * * `NOT_FOUND` if any users specified in the query arguments do not exist.
    *
    * Request parameters:
    *
-   * [pageSize] - Maximum number of items to return. Zero or unspecified
-   * indicates that the
-   * server may assign a maximum.
-   *
-   * The server may return fewer than the specified number of results.
-   *
    * [courseStates] - Restricts returned courses to those in one of the
    * specified states
    * The default value is ACTIVE, ARCHIVED, PROVISIONED, DECLINED.
    *
    * [teacherId] - Restricts returned courses to those having a teacher with the
    * specified
    * identifier. 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
    *
    * [studentId] - Restricts returned courses to those having a student with the
    * specified
    * identifier. 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
    *
    * [pageToken] - nextPageToken
    * value returned from a previous
    * list call,
    * indicating that the subsequent page of results should be returned.
    *
    * The list request must be
    * otherwise identical to the one that resulted in this token.
    *
+   * [pageSize] - Maximum number of items to return. Zero or unspecified
+   * indicates that the
+   * server may assign a maximum.
+   *
+   * The server may return fewer than the specified number of results.
+   *
    * Completes with a [ListCoursesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListCoursesResponse> list({core.int pageSize, core.List<core.String> courseStates, core.String teacherId, core.String studentId, core.String pageToken}) {
+  async.Future<ListCoursesResponse> list({core.List<core.String> courseStates, core.String teacherId, core.String studentId, core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (courseStates != null) {
       _queryParams["courseStates"] = courseStates;
     }
     if (teacherId != null) {
       _queryParams["teacherId"] = [teacherId];
     }
     if (studentId != null) {
       _queryParams["studentId"] = [studentId];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
 
     _url = 'v1/courses';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 24 matching lines @@
    * [updateMask] - Mask that identifies which fields on the course to update.
    * This field is required to do an update. The update will fail if invalid
    * fields are specified. The following fields are valid:
    *
    * * `name`
    * * `section`
    * * `descriptionHeading`
    * * `description`
    * * `room`
    * * `courseState`
+   * * `ownerId`
+   *
+   * Note: patches to ownerId are treated as being effective immediately, but in
+   * practice it may take some time for the ownership transfer of all affected
+   * resources to complete.
    *
    * When set in a query parameter, this field should be specified as
    *
    * `updateMask=<field1>,<field2>,...`
    *
    * Completes with a [Course].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 471 matching lines @@
    * the requested course or for access errors.
    * * `INVALID_ARGUMENT` if the request is malformed.
    * * `NOT_FOUND` if the requested course does not exist.
    *
    * Request parameters:
    *
    * [courseId] - Identifier of the course.
    * This identifier can be either the Classroom-assigned identifier or an
    * alias.
    *
-   * [pageSize] - Maximum number of items to return. Zero or unspecified
-   * indicates that the
-   * server may assign a maximum.
-   *
-   * The server may return fewer than the specified number of results.
-   *
-   * [courseWorkStates] - Restriction on the work status to return. Only
-   * courseWork that matches
-   * is returned. If unspecified, items with a work status of `PUBLISHED`
-   * is returned.
-   *
    * [pageToken] - nextPageToken
    * value returned from a previous
    * list call,
    * indicating that the subsequent page of results should be returned.
    *
    * The list request
    * must be otherwise identical to the one that resulted in this token.
    *
    * [orderBy] - Optional sort ordering for results. A comma-separated list of
    * fields with
    * an optional sort direction keyword. Supported fields are `updateTime`
    * and `dueDate`. Supported direction keywords are `asc` and `desc`.
    * If not specified, `updateTime desc` is the default behavior.
    * Examples: `dueDate asc,updateTime desc`, `updateTime,dueDate desc`
    *
+   * [pageSize] - Maximum number of items to return. Zero or unspecified
+   * indicates that the
+   * server may assign a maximum.
+   *
+   * The server may return fewer than the specified number of results.
+   *
+   * [courseWorkStates] - Restriction on the work status to return. Only
+   * courseWork that matches
+   * is returned. If unspecified, items with a work status of `PUBLISHED`
+   * is returned.
+   *
    * Completes with a [ListCourseWorkResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListCourseWorkResponse> list(core.String courseId, {core.int pageSize, core.List<core.String> courseWorkStates, core.String pageToken, core.String orderBy}) {
+  async.Future<ListCourseWorkResponse> list(core.String courseId, {core.String pageToken, core.String orderBy, core.int pageSize, core.List<core.String> courseWorkStates}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (courseId == null) {
       throw new core.ArgumentError("Parameter courseId is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+    if (orderBy != null) {
+      _queryParams["orderBy"] = [orderBy];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (courseWorkStates != null) {
       _queryParams["courseWorkStates"] = courseWorkStates;
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
-    if (orderBy != null) {
-      _queryParams["orderBy"] = [orderBy];
-    }
 
     _url = 'v1/courses/' + commons.Escaper.ecapeVariable('$courseId') + '/courseWork';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 174 matching lines @@
    * requested course or course work, or for access errors.
    * * `INVALID_ARGUMENT` if the request is malformed.
    * * `NOT_FOUND` if the requested course does not exist.
    *
    * Request parameters:
    *
    * [courseId] - Identifier of the course.
    * This identifier can be either the Classroom-assigned identifier or an
    * alias.
    *
-   * [courseWorkId] - Identifer of the student work to request.
+   * [courseWorkId] - Identifier of the student work to request.
    * This may be set to the string literal `"-"` to request student work for
    * all course work in the specified course.
    *
    * [late] - Requested lateness value. If specified, returned student
    * submissions are
    * restricted by the requested value.
    * If unspecified, submissions are returned regardless of `late` value.
    * Possible string values are:
    * - "LATE_VALUES_UNSPECIFIED" : A LATE_VALUES_UNSPECIFIED.
    * - "LATE_ONLY" : A LATE_ONLY.
@@ skipping 664 matching lines @@
    *
    * * `NOT_FOUND` if the course does not exist.
    * * `PERMISSION_DENIED` for access errors.
    *
    * Request parameters:
    *
    * [courseId] - Identifier of the course.
    * This identifier can be either the Classroom-assigned identifier or an
    * alias.
    *
-   * [pageSize] - Maximum number of items to return. Zero means no maximum.
-   *
-   * The server may return fewer than the specified number of results.
-   *
    * [pageToken] - nextPageToken
    * value returned from a previous
    * list call, indicating that
    * the subsequent page of results should be returned.
    *
    * The list request must be
    * otherwise identical to the one that resulted in this token.
    *
+   * [pageSize] - Maximum number of items to return. Zero means no maximum.
+   *
+   * The server may return fewer than the specified number of results.
+   *
    * Completes with a [ListStudentsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListStudentsResponse> list(core.String courseId, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListStudentsResponse> list(core.String courseId, {core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (courseId == null) {
       throw new core.ArgumentError("Parameter courseId is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1/courses/' + commons.Escaper.ecapeVariable('$courseId') + '/students';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 761 matching lines @@
    * returned.
    * 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
    * * the string literal `"-"`, indicating that results should be returned for
    *   all students that the requesting user is permitted to view guardian
    *   invitations.
    *
-   * [pageToken] - nextPageToken
-   * value returned from a previous
-   * list call,
-   * indicating that the subsequent page of results should be returned.
-   *
-   * The list request
-   * must be otherwise identical to the one that resulted in this token.
-   *
    * [pageSize] - Maximum number of items to return. Zero or unspecified
    * indicates that the
    * server may assign a maximum.
    *
    * The server may return fewer than the specified number of results.
    *
    * [states] - If specified, only results with the specified `state` values
    * will be
    * returned. Otherwise, results with a `state` of `PENDING` will be returned.
    *
    * [invitedEmailAddress] - If specified, only results with the specified
    * `invited_email_address`
    * will be returned.
    *
+   * [pageToken] - nextPageToken
+   * value returned from a previous
+   * list call,
+   * indicating that the subsequent page of results should be returned.
+   *
+   * The list request
+   * must be otherwise identical to the one that resulted in this token.
+   *
    * Completes with a [ListGuardianInvitationsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListGuardianInvitationsResponse> list(core.String studentId, {core.String pageToken, core.int pageSize, core.List<core.String> states, core.String invitedEmailAddress}) {
+  async.Future<ListGuardianInvitationsResponse> list(core.String studentId, {core.int pageSize, core.List<core.String> states, core.String invitedEmailAddress, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (studentId == null) {
       throw new core.ArgumentError("Parameter studentId is required.");
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (states != null) {
       _queryParams["states"] = states;
     }
     if (invitedEmailAddress != null) {
       _queryParams["invitedEmailAddress"] = [invitedEmailAddress];
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'v1/userProfiles/' + commons.Escaper.ecapeVariable('$studentId') + '/guardianInvitations';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 540 matching lines @@
    *
    * When specified as a parameter of a
    * create course request, this
    * field is required.
    * 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
    *
-   * This must be set in a create request. Specifying this field in a course
-   * update mask results in an `INVALID_ARGUMENT` error.
+   * This must be set in a create request. Admins can also specify this field
+   * in a patch course request to
+   * transfer ownership. In other contexts, it is read-only.
    */
   core.String ownerId;
   /**
    * Optional room location.
    * For example, "301".
    * If set, this field must be a valid UTF-8 string and no longer than 650
    * characters.
    */
   core.String room;
   /**
@@ skipping 792 matching lines @@
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (permission != null) {
       _json["permission"] = permission;
     }
     return _json;
   }
 }
 
+/** The history of each grade on this submission. */
+class GradeHistory {
+  /** The teacher who made the grade change. */
+  core.String actorUserId;
+  /**
+   * The type of grade change at this time in the submission grade history.
+   * Possible string values are:
+   * - "UNKNOWN_GRADE_CHANGE_TYPE" : No grade change type specified. This should
+   * never be returned.
+   * - "DRAFT_GRADE_POINTS_EARNED_CHANGE" : A change in the numerator of the
+   * draft grade.
+   * - "ASSIGNED_GRADE_POINTS_EARNED_CHANGE" : A change in the numerator of the
+   * assigned grade.
+   * - "MAX_POINTS_CHANGE" : A change in the denominator of the grade.
+   */
+  core.String gradeChangeType;
+  /** When the grade of the submission was changed. */
+  core.String gradeTimestamp;
+  /**
+   * The denominator of the grade at this time in the submission grade
+   * history.
+   */
+  core.double maxPoints;
+  /**
+   * The numerator of the grade at this time in the submission grade history.
+   */
+  core.double pointsEarned;
+
+  GradeHistory();
+
+  GradeHistory.fromJson(core.Map _json) {
+    if (_json.containsKey("actorUserId")) {
+      actorUserId = _json["actorUserId"];
+    }
+    if (_json.containsKey("gradeChangeType")) {
+      gradeChangeType = _json["gradeChangeType"];
+    }
+    if (_json.containsKey("gradeTimestamp")) {
+      gradeTimestamp = _json["gradeTimestamp"];
+    }
+    if (_json.containsKey("maxPoints")) {
+      maxPoints = _json["maxPoints"];
+    }
+    if (_json.containsKey("pointsEarned")) {
+      pointsEarned = _json["pointsEarned"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (actorUserId != null) {
+      _json["actorUserId"] = actorUserId;
+    }
+    if (gradeChangeType != null) {
+      _json["gradeChangeType"] = gradeChangeType;
+    }
+    if (gradeTimestamp != null) {
+      _json["gradeTimestamp"] = gradeTimestamp;
+    }
+    if (maxPoints != null) {
+      _json["maxPoints"] = maxPoints;
+    }
+    if (pointsEarned != null) {
+      _json["pointsEarned"] = pointsEarned;
+    }
+    return _json;
+  }
+}
+
 /**
  * Association between a student and a guardian of that student. The guardian
  * may receive information about the student's course work.
  */
 class Guardian {
   /** Identifier for the guardian. */
   core.String guardianId;
   /** User profile for the guardian. */
   UserProfile guardianProfile;
   /**
@@ skipping 125 matching lines @@
    * Read-only.
    */
   core.String id;
   /**
    * Role to invite the user to have.
    * Must not be `COURSE_ROLE_UNSPECIFIED`.
    * Possible string values are:
    * - "COURSE_ROLE_UNSPECIFIED" : No course role.
    * - "STUDENT" : Student in the course.
    * - "TEACHER" : Teacher of the course.
+   * - "OWNER" : Owner of the course.
    */
   core.String role;
   /**
    * 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
@@ skipping 641 matching lines @@
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (answer != null) {
       _json["answer"] = answer;
     }
     return _json;
   }
 }
 
+/** The history of each state this submission has been in. */
+class StateHistory {
+  /** The teacher or student who made the change */
+  core.String actorUserId;
+  /**
+   * The workflow pipeline stage.
+   * Possible string values are:
+   * - "STATE_UNSPECIFIED" : No state specified. This should never be returned.
+   * - "CREATED" : The Submission has been created.
+   * - "TURNED_IN" : The student has turned in an assigned document, which may
+   * or may not be
+   * a template.
+   * - "RETURNED" : The teacher has returned the assigned document to the
+   * student.
+   * - "RECLAIMED_BY_STUDENT" : The student turned in the assigned document, and
+   * then chose to
+   * "unsubmit" the assignment, giving the student control again as the
+   * owner.
+   * - "STUDENT_EDITED_AFTER_TURN_IN" : The student edited their submission
+   * after turning it in. Currently,
+   * only used by Questions, when the student edits their answer.
+   */
+  core.String state;
+  /** When the submission entered this state. */
+  core.String stateTimestamp;
+
+  StateHistory();
+
+  StateHistory.fromJson(core.Map _json) {
+    if (_json.containsKey("actorUserId")) {
+      actorUserId = _json["actorUserId"];
+    }
+    if (_json.containsKey("state")) {
+      state = _json["state"];
+    }
+    if (_json.containsKey("stateTimestamp")) {
+      stateTimestamp = _json["stateTimestamp"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (actorUserId != null) {
+      _json["actorUserId"] = actorUserId;
+    }
+    if (state != null) {
+      _json["state"] = state;
+    }
+    if (stateTimestamp != null) {
+      _json["stateTimestamp"] = stateTimestamp;
+    }
+    return _json;
+  }
+}
+
 /** Student in a course. */
 class Student {
   /**
    * Identifier of the course.
    *
    * Read-only.
    */
   core.String courseId;
   /**
    * Global user information for the student.
@@ skipping 65 matching lines @@
  */
 class StudentSubmission {
   /**
    * Absolute link to the submission in the Classroom web UI.
    *
    * Read-only.
    */
   core.String alternateLink;
   /**
    * Optional grade. If unset, no grade was set.
-   * This must be a non-negative integer value.
+   * This value must be non-negative. Decimal (i.e. non-integer) values are
+   * allowed, but will be rounded to two decimal places.
    *
    * This may be modified only by course teachers.
    */
   core.double assignedGrade;
   /** Submission content when course_work_type is ASSIGNMENT . */
   AssignmentSubmission assignmentSubmission;
   /**
    * Whether this student submission is associated with the Developer Console
    * project making the request.
    *
@@ skipping 29 matching lines @@
   core.String courseWorkType;
   /**
    * Creation time of this submission.
    * This may be unset if the student has not accessed this item.
    *
    * Read-only.
    */
   core.String creationTime;
   /**
    * Optional pending grade. If unset, no grade was set.
-   * This must be a non-negative integer value.
+   * This value must be non-negative. Decimal (i.e. non-integer) values are
+   * allowed, but will be rounded to two decimal places.
    *
    * This is only visible to and modifiable by course teachers.
    */
   core.double draftGrade;
   /**
    * Classroom-assigned Identifier for the student submission.
    * This is unique among submissions for the relevant course work.
    *
    * Read-only.
    */
@@ skipping 18 matching lines @@
    * - "NEW" : The student has never accessed this submission. Attachments are
    * not
    * returned and timestamps is not set.
    * - "CREATED" : Has been created.
    * - "TURNED_IN" : Has been turned in to the teacher.
    * - "RETURNED" : Has been returned to the student.
    * - "RECLAIMED_BY_STUDENT" : Student chose to "unsubmit" the assignment.
    */
   core.String state;
   /**
+   * The history of the submission (includes state and grade histories).
+   *
+   * Read-only.
+   */
+  core.List<SubmissionHistory> submissionHistory;
+  /**
    * Last update time of this submission.
    * This may be unset if the student has not accessed this item.
    *
    * Read-only.
    */
   core.String updateTime;
   /**
    * Identifier for the student that owns this submission.
    *
    * Read-only.
@@ skipping 38 matching lines @@
     }
     if (_json.containsKey("multipleChoiceSubmission")) {
       multipleChoiceSubmission = new MultipleChoiceSubmission.fromJson(_json["multipleChoiceSubmission"]);
     }
     if (_json.containsKey("shortAnswerSubmission")) {
       shortAnswerSubmission = new ShortAnswerSubmission.fromJson(_json["shortAnswerSubmission"]);
     }
     if (_json.containsKey("state")) {
       state = _json["state"];
     }
+    if (_json.containsKey("submissionHistory")) {
+      submissionHistory = _json["submissionHistory"].map((value) => new SubmissionHistory.fromJson(value)).toList();
+    }
     if (_json.containsKey("updateTime")) {
       updateTime = _json["updateTime"];
     }
     if (_json.containsKey("userId")) {
       userId = _json["userId"];
     }
   }
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
@@ skipping 32 matching lines @@
     }
     if (multipleChoiceSubmission != null) {
       _json["multipleChoiceSubmission"] = (multipleChoiceSubmission).toJson();
     }
     if (shortAnswerSubmission != null) {
       _json["shortAnswerSubmission"] = (shortAnswerSubmission).toJson();
     }
     if (state != null) {
       _json["state"] = state;
     }
+    if (submissionHistory != null) {
+      _json["submissionHistory"] = submissionHistory.map((value) => (value).toJson()).toList();
+    }
     if (updateTime != null) {
       _json["updateTime"] = updateTime;
     }
     if (userId != null) {
       _json["userId"] = userId;
     }
     return _json;
   }
 }
 
+/**
+ * The history of the submission. This currently includes state and grade
+ * histories.
+ */
+class SubmissionHistory {
+  /** The grade history information of the submission, if present. */
+  GradeHistory gradeHistory;
+  /** The state history information of the submission, if present. */
+  StateHistory stateHistory;
+
+  SubmissionHistory();
+
+  SubmissionHistory.fromJson(core.Map _json) {
+    if (_json.containsKey("gradeHistory")) {
+      gradeHistory = new GradeHistory.fromJson(_json["gradeHistory"]);
+    }
+    if (_json.containsKey("stateHistory")) {
+      stateHistory = new StateHistory.fromJson(_json["stateHistory"]);
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (gradeHistory != null) {
+      _json["gradeHistory"] = (gradeHistory).toJson();
+    }
+    if (stateHistory != null) {
+      _json["stateHistory"] = (stateHistory).toJson();
+    }
+    return _json;
+  }
+}
+
 /** Teacher of a course. */
 class Teacher {
   /**
    * Identifier of the course.
    *
    * Read-only.
    */
   core.String courseId;
   /**
    * Global user information for the teacher.
@@ skipping 250 matching lines @@
     }
     if (thumbnailUrl != null) {
       _json["thumbnailUrl"] = thumbnailUrl;
     }
     if (title != null) {
       _json["title"] = title;
     }
     return _json;
   }
 }