Api-Roll 53: 2017-08-21

generated/googleapis/lib/people/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.people.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 50 matching lines @@
 
   ContactGroupsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Get a list of contact groups owned by the authenticated user by specifying
    * a list of contact group resource names.
    *
    * Request parameters:
    *
-   * [resourceNames] - The resource names of the contact groups to get.
-   *
    * [maxMembers] - Specifies the maximum number of members to return for each
    * group.
    *
+   * [resourceNames] - The resource names of the contact groups to get.
+   *
    * Completes with a [BatchGetContactGroupsResponse].
    *
    * 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<BatchGetContactGroupsResponse> batchGet({core.List<core.String> resourceNames, core.int maxMembers}) {
+  async.Future<BatchGetContactGroupsResponse> batchGet({core.int maxMembers, core.List<core.String> resourceNames}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
+    if (maxMembers != null) {
+      _queryParams["maxMembers"] = ["${maxMembers}"];
+    }
     if (resourceNames != null) {
       _queryParams["resourceNames"] = resourceNames;
     }
-    if (maxMembers != null) {
-      _queryParams["maxMembers"] = ["${maxMembers}"];
-    }
 
     _url = 'v1/contactGroups:batchGet';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 131 matching lines @@
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ContactGroup.fromJson(data));
   }
 
   /**
    * List all contact groups owned by the authenticated user. Members of the
    * contact groups are not populated.
    *
    * Request parameters:
    *
+   * [pageToken] - The next_page_token value returned from a previous call to
+   * [ListContactGroups](/people/api/rest/v1/contactgroups/list).
+   * Requests the next page of resources.
+   *
    * [pageSize] - The maximum number of resources to return.
    *
    * [syncToken] - A sync token, returned by a previous call to
    * `contactgroups.list`.
    * Only resources changed since the sync token was created will be returned.
    *
-   * [pageToken] - The next_page_token value returned from a previous call to
-   * [ListContactGroups](/people/api/rest/v1/contactgroups/list).
-   * Requests the next page of resources.
-   *
    * Completes with a [ListContactGroupsResponse].
    *
    * 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<ListContactGroupsResponse> list({core.int pageSize, core.String syncToken, core.String pageToken}) {
+  async.Future<ListContactGroupsResponse> list({core.String pageToken, core.int pageSize, core.String syncToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (syncToken != null) {
       _queryParams["syncToken"] = [syncToken];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1/contactGroups';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 209 matching lines @@
    * about.
    *
    * - To get information about the authenticated user, specify `people/me`.
    * - To get information about a google account, specify
    *  `people/`<var>account_id</var>.
    * - To get information about a contact, specify the resource name that
    *   identifies the contact as returned by
    * [`people.connections.list`](/people/api/rest/v1/people.connections/list).
    * Value must have pattern "^people/[^/]+$".
    *
+   * [requestMask_includeField] - **Required.** Comma-separated list of person
+   * fields to be included in the
+   * response. Each path should start with `person.`: for example,
+   * `person.names` or `person.photos`.
+   *
    * [personFields] - **Required.** A field mask to restrict which fields on the
    * person are
    * returned. Valid values are:
    *
    * * addresses
    * * ageRanges
    * * biographies
    * * birthdays
    * * braggingRights
    * * coverPhotos
@@ skipping 12 matching lines @@
    * * phoneNumbers
    * * photos
    * * relations
    * * relationshipInterests
    * * relationshipStatuses
    * * residences
    * * skills
    * * taglines
    * * urls
    *
-   * [requestMask_includeField] - **Required.** Comma-separated list of person
-   * fields to be included in the
-   * response. Each path should start with `person.`: for example,
-   * `person.names` or `person.photos`.
-   *
    * Completes with a [Person].
    *
    * 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<Person> get(core.String resourceName, {core.String personFields, core.String requestMask_includeField}) {
+  async.Future<Person> get(core.String resourceName, {core.String requestMask_includeField, core.String personFields}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (resourceName == null) {
       throw new core.ArgumentError("Parameter resourceName is required.");
     }
+    if (requestMask_includeField != null) {
+      _queryParams["requestMask.includeField"] = [requestMask_includeField];
+    }
     if (personFields != null) {
       _queryParams["personFields"] = [personFields];
     }
-    if (requestMask_includeField != null) {
-      _queryParams["requestMask.includeField"] = [requestMask_includeField];
-    }
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Person.fromJson(data));
   }
 
   /**
    * Provides information about a list of specific people by specifying a list
    * of requested resource names. Use `people/me` to indicate the authenticated
    * user.
    * <br>
    * The request throws a 400 error if 'personFields' is not specified.
    *
    * Request parameters:
    *
+   * [requestMask_includeField] - **Required.** Comma-separated list of person
+   * fields to be included in the
+   * response. Each path should start with `person.`: for example,
+   * `person.names` or `person.photos`.
+   *
+   * [resourceNames] - The resource names of the people to provide information
+   * about.
+   *
+   * - To get information about the authenticated user, specify `people/me`.
+   * - To get information about a google account, specify
+   *   `people/`<var>account_id</var>.
+   * - To get information about a contact, specify the resource name that
+   *   identifies the contact as returned by
+   * [`people.connections.list`](/people/api/rest/v1/people.connections/list).
+   *
+   * You can include up to 50 resource names in one request.
+   *
    * [personFields] - **Required.** A field mask to restrict which fields on
    * each person are
    * returned. Valid values are:
    *
    * * addresses
    * * ageRanges
    * * biographies
    * * birthdays
    * * braggingRights
    * * coverPhotos
@@ skipping 12 matching lines @@
    * * phoneNumbers
    * * photos
    * * relations
    * * relationshipInterests
    * * relationshipStatuses
    * * residences
    * * skills
    * * taglines
    * * urls
    *
-   * [requestMask_includeField] - **Required.** Comma-separated list of person
-   * fields to be included in the
-   * response. Each path should start with `person.`: for example,
-   * `person.names` or `person.photos`.
-   *
-   * [resourceNames] - The resource names of the people to provide information
-   * about.
-   *
-   * - To get information about the authenticated user, specify `people/me`.
-   * - To get information about a google account, specify
-   *   `people/`<var>account_id</var>.
-   * - To get information about a contact, specify the resource name that
-   *   identifies the contact as returned by
-   * [`people.connections.list`](/people/api/rest/v1/people.connections/list).
-   *
-   * You can include up to 50 resource names in one request.
-   *
    * Completes with a [GetPeopleResponse].
    *
    * 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<GetPeopleResponse> getBatchGet({core.String personFields, core.String requestMask_includeField, core.List<core.String> resourceNames}) {
+  async.Future<GetPeopleResponse> getBatchGet({core.String requestMask_includeField, core.List<core.String> resourceNames, core.String personFields}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-    if (personFields != null) {
-      _queryParams["personFields"] = [personFields];
-    }
     if (requestMask_includeField != null) {
       _queryParams["requestMask.includeField"] = [requestMask_includeField];
     }
     if (resourceNames != null) {
       _queryParams["resourceNames"] = resourceNames;
     }
+    if (personFields != null) {
+      _queryParams["personFields"] = [personFields];
+    }
 
     _url = 'v1/people:batchGet';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 146 matching lines @@
    * - "LAST_MODIFIED_ASCENDING" : A LAST_MODIFIED_ASCENDING.
    * - "FIRST_NAME_ASCENDING" : A FIRST_NAME_ASCENDING.
    * - "LAST_NAME_ASCENDING" : A LAST_NAME_ASCENDING.
    *
    * [requestSyncToken] - Whether the response should include a sync token,
    * which can be used to get
    * all changes since the last request.
    *
    * [pageToken] - The token of the page to be returned.
    *
-   * [pageSize] - The number of connections to include in the response. Valid
-   * values are
-   * between 1 and 2000, inclusive. Defaults to 100.
-   *
    * [requestMask_includeField] - **Required.** Comma-separated list of person
    * fields to be included in the
    * response. Each path should start with `person.`: for example,
    * `person.names` or `person.photos`.
    *
+   * [pageSize] - The number of connections to include in the response. Valid
+   * values are
+   * between 1 and 2000, inclusive. Defaults to 100.
+   *
    * [syncToken] - A sync token, returned by a previous call to
    * `people.connections.list`.
    * Only resources changed since the sync token was created will be returned.
    *
    * Completes with a [ListConnectionsResponse].
    *
    * 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<ListConnectionsResponse> list(core.String resourceName, {core.String personFields, core.String sortOrder, core.bool requestSyncToken, core.String pageToken, core.int pageSize, core.String requestMask_includeField, core.String syncToken}) {
+  async.Future<ListConnectionsResponse> list(core.String resourceName, {core.String personFields, core.String sortOrder, core.bool requestSyncToken, core.String pageToken, core.String requestMask_includeField, core.int pageSize, core.String syncToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (resourceName == null) {
       throw new core.ArgumentError("Parameter resourceName is required.");
     }
     if (personFields != null) {
       _queryParams["personFields"] = [personFields];
     }
     if (sortOrder != null) {
       _queryParams["sortOrder"] = [sortOrder];
     }
     if (requestSyncToken != null) {
       _queryParams["requestSyncToken"] = ["${requestSyncToken}"];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (requestMask_includeField != null) {
+      _queryParams["requestMask.includeField"] = [requestMask_includeField];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (requestMask_includeField != null) {
-      _queryParams["requestMask.includeField"] = [requestMask_includeField];
-    }
     if (syncToken != null) {
       _queryParams["syncToken"] = [syncToken];
     }
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/connections';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
@@ skipping 2728 matching lines @@
     }
     if (type != null) {
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }