Api-Roll 52: 2017-07-31

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 836 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.String pageToken, core.String orderBy, core.int pageSize, core.List<core.String> courseWorkStates}) {
+  async.Future<ListCourseWorkResponse> list(core.String courseId, {core.int pageSize, core.List<core.String> courseWorkStates, core.String pageToken, core.String orderBy}) {
     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 (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (courseWorkStates != null) {
+      _queryParams["courseWorkStates"] = courseWorkStates;
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (orderBy != null) {
       _queryParams["orderBy"] = [orderBy];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
-    if (courseWorkStates != null) {
-      _queryParams["courseWorkStates"] = courseWorkStates;
-    }
 
     _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 178 matching lines @@
    * 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.
    * 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.
+   * - "NOT_LATE_ONLY" : A NOT_LATE_ONLY.
+   *
    * [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.
    *
+   * [states] - Requested submission states. If specified, returned student
+   * submissions
+   * match one of the specified submission states.
+   *
    * [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] - Requested submission states. If specified, returned student
-   * submissions
-   * match one of the specified submission states.
-   *
    * [userId] - Optional argument to restrict returned student work to those
    * owned by the
    * 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
    *
-   * [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.
-   * - "NOT_LATE_ONLY" : A NOT_LATE_ONLY.
-   *
    * Completes with a [ListStudentSubmissionsResponse].
    *
    * 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<ListStudentSubmissionsResponse> list(core.String courseId, core.String courseWorkId, {core.String pageToken, core.int pageSize, core.List<core.String> states, core.String userId, core.String late}) {
+  async.Future<ListStudentSubmissionsResponse> list(core.String courseId, core.String courseWorkId, {core.String late, core.String pageToken, core.List<core.String> states, core.int pageSize, core.String userId}) {
     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 (courseWorkId == null) {
       throw new core.ArgumentError("Parameter courseWorkId is required.");
     }
+    if (late != null) {
+      _queryParams["late"] = [late];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (states != null) {
+      _queryParams["states"] = states;
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (states != null) {
-      _queryParams["states"] = states;
-    }
     if (userId != null) {
       _queryParams["userId"] = [userId];
     }
-    if (late != null) {
-      _queryParams["late"] = [late];
-    }
 
     _url = 'v1/courses/' + commons.Escaper.ecapeVariable('$courseId') + '/courseWork/' + commons.Escaper.ecapeVariable('$courseWorkId') + '/studentSubmissions';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 588 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.String pageToken, core.int pageSize}) {
+  async.Future<ListStudentsResponse> list(core.String courseId, {core.int pageSize, 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 (courseId == null) {
       throw new core.ArgumentError("Parameter courseId is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _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 1146 matching lines @@
   }
 
 }
 
 
 
 /** Additional details for assignments. */
 class Assignment {
   /**
    * Drive folder where attachments from student submissions are placed.
-   * This is only populated for course teachers.
+   * This is only populated for course teachers and administrators.
    */
   DriveFolder studentWorkFolder;
 
   Assignment();
 
   Assignment.fromJson(core.Map _json) {
     if (_json.containsKey("studentWorkFolder")) {
       studentWorkFolder = new DriveFolder.fromJson(_json["studentWorkFolder"]);
     }
   }
@@ skipping 2391 matching lines @@
     }
     if (thumbnailUrl != null) {
       _json["thumbnailUrl"] = thumbnailUrl;
     }
     if (title != null) {
       _json["title"] = title;
     }
     return _json;
   }
 }