Api-Roll 51: 2017-07-10

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 28 matching lines @@
 
   /** View your email address */
   static const UserinfoEmailScope = "https://www.googleapis.com/auth/userinfo.email";
 
   /** View your basic profile info */
   static const UserinfoProfileScope = "https://www.googleapis.com/auth/userinfo.profile";
 
 
   final commons.ApiRequester _requester;
 
+  ContactGroupsResourceApi get contactGroups => new ContactGroupsResourceApi(_requester);
   PeopleResourceApi get people => new PeopleResourceApi(_requester);
 
   PeopleApi(http.Client client, {core.String rootUrl: "https://people.googleapis.com/", core.String servicePath: ""}) :
       _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
 }
 
 
+class ContactGroupsResourceApi {
+  final commons.ApiRequester _requester;
+
+  ContactGroupsMembersResourceApi get members => new ContactGroupsMembersResourceApi(_requester);
+
+  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:
+   *
+   * [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.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;
+    }
+
+    _url = 'v1/contactGroups:batchGet';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new BatchGetContactGroupsResponse.fromJson(data));
+  }
+
+  /**
+   * Create a new contact group owned by the authenticated user.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * Completes with a [ContactGroup].
+   *
+   * 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<ContactGroup> create(CreateContactGroupRequest request) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+
+    _url = 'v1/contactGroups';
+
+    var _response = _requester.request(_url,
+                                       "POST",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new ContactGroup.fromJson(data));
+  }
+
+  /**
+   * Delete an existing contact group owned by the authenticated user by
+   * specifying a contact group resource name.
+   *
+   * Request parameters:
+   *
+   * [resourceName] - The resource name of the contact group to delete.
+   * Value must have pattern "^contactGroups/[^/]+$".
+   *
+   * [deleteContacts] - Set to true to also delete the contacts in the specified
+   * group.
+   *
+   * Completes with a [Empty].
+   *
+   * 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<Empty> delete(core.String resourceName, {core.bool deleteContacts}) {
+    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 (deleteContacts != null) {
+      _queryParams["deleteContacts"] = ["${deleteContacts}"];
+    }
+
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName');
+
+    var _response = _requester.request(_url,
+                                       "DELETE",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Empty.fromJson(data));
+  }
+
+  /**
+   * Get a specific contact group owned by the authenticated user by specifying
+   * a contact group resource name.
+   *
+   * Request parameters:
+   *
+   * [resourceName] - The resource name of the contact group to get.
+   * Value must have pattern "^contactGroups/[^/]+$".
+   *
+   * [maxMembers] - Specifies the maximum number of members to return.
+   *
+   * Completes with a [ContactGroup].
+   *
+   * 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<ContactGroup> get(core.String resourceName, {core.int maxMembers}) {
+    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 (maxMembers != null) {
+      _queryParams["maxMembers"] = ["${maxMembers}"];
+    }
+
+    _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 ContactGroup.fromJson(data));
+  }
+
+  /**
+   * List all contact groups owned by the authenticated user. Members of the
+   * contact groups are not populated.
+   *
+   * Request parameters:
+   *
+   * [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.
+   *
+   * [pageSize] - The maximum number of resources to return.
+   *
+   * 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.String syncToken, 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 (syncToken != null) {
+      _queryParams["syncToken"] = [syncToken];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+
+    _url = 'v1/contactGroups';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new ListContactGroupsResponse.fromJson(data));
+  }
+
+  /**
+   * Update the name of an existing contact group owned by the authenticated
+   * user.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * [resourceName] - The resource name for the contact group, assigned by the
+   * server. An ASCII
+   * string, in the form of `contactGroups/<contact_group_id>`.
+   * Value must have pattern "^contactGroups/[^/]+$".
+   *
+   * Completes with a [ContactGroup].
+   *
+   * 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<ContactGroup> update(UpdateContactGroupRequest request, core.String resourceName) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+    if (resourceName == null) {
+      throw new core.ArgumentError("Parameter resourceName is required.");
+    }
+
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName');
+
+    var _response = _requester.request(_url,
+                                       "PUT",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new ContactGroup.fromJson(data));
+  }
+
+}
+
+
+class ContactGroupsMembersResourceApi {
+  final commons.ApiRequester _requester;
+
+  ContactGroupsMembersResourceApi(commons.ApiRequester client) : 
+      _requester = client;
+
+  /**
+   * Modify the members of a contact group owned by the authenticated user.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * [resourceName] - The resource name of the contact group to modify.
+   * Value must have pattern "^contactGroups/[^/]+$".
+   *
+   * Completes with a [ModifyContactGroupMembersResponse].
+   *
+   * 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<ModifyContactGroupMembersResponse> modify(ModifyContactGroupMembersRequest request, core.String resourceName) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+    if (resourceName == null) {
+      throw new core.ArgumentError("Parameter resourceName is required.");
+    }
+
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/members:modify';
+
+    var _response = _requester.request(_url,
+                                       "POST",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new ModifyContactGroupMembersResponse.fromJson(data));
+  }
+
+}
+
+
 class PeopleResourceApi {
   final commons.ApiRequester _requester;
 
   PeopleConnectionsResourceApi get connections => new PeopleConnectionsResourceApi(_requester);
 
   PeopleResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Provides information about a person by specifying a resource name. Use
-   * `people/me` to indicate the authenticated user.
+   * Create a new contact and return the person resource for that contact.
+   *
+   * [request] - The metadata request object.
    *
    * Request parameters:
    *
+   * [parent] - The resource name of the owning person resource.
+   *
+   * 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> createContact(Person request, {core.String parent}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+    if (parent != null) {
+      _queryParams["parent"] = [parent];
+    }
+
+    _url = 'v1/people:createContact';
+
+    var _response = _requester.request(_url,
+                                       "POST",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Person.fromJson(data));
+  }
+
+  /**
+   * Delete a contact person. Any non-contact data will not be deleted.
+   *
+   * Request parameters:
+   *
+   * [resourceName] - The resource name of the contact to delete.
+   * Value must have pattern "^people/[^/]+$".
+   *
+   * Completes with a [Empty].
+   *
+   * 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<Empty> deleteContact(core.String resourceName) {
+    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.");
+    }
+
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + ':deleteContact';
+
+    var _response = _requester.request(_url,
+                                       "DELETE",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Empty.fromJson(data));
+  }
+
+  /**
+   * Provides information about a person by specifying a resource name. Use
+   * `people/me` to indicate the authenticated user.
+   * <br>
+   * The request throws a 400 error if 'personFields' is not specified.
+   *
+   * Request parameters:
+   *
    * [resourceName] - The resource name of the person to provide information
    * about.
    *
    * - To get information about the authenticated user, specify `people/me`.
-   * - To get information about any user, specify the resource name that
-   *   identifies the user, such as the resource names returned by
+   * - To get information about a google account, specify `people/<account_id>`.
+   * - 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
+   * [personFields] - **Required.** A field mask to restrict which fields on the
+   * person are
+   * returned. Valid values are:
+   *
+   * * addresses
+   * * ageRanges
+   * * biographies
+   * * birthdays
+   * * braggingRights
+   * * coverPhotos
+   * * emailAddresses
+   * * events
+   * * genders
+   * * imClients
+   * * interests
+   * * locales
+   * * memberships
+   * * metadata
+   * * names
+   * * nicknames
+   * * occupations
+   * * organizations
+   * * 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 requestMask_includeField}) {
+  async.Future<Person> get(core.String resourceName, {core.String personFields, core.String requestMask_includeField}) {
     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 (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
+   * [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 name, such as one returned by
    * [`people.connections.list`](/people/api/rest/v1/people.connections/list),
    * of one of the people to provide information about. You can include this
    * parameter up to 50 times 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
+   * * emailAddresses
+   * * events
+   * * genders
+   * * imClients
+   * * interests
+   * * locales
+   * * memberships
+   * * metadata
+   * * names
+   * * nicknames
+   * * occupations
+   * * organizations
+   * * phoneNumbers
+   * * photos
+   * * relations
+   * * relationshipInterests
+   * * relationshipStatuses
+   * * residences
+   * * skills
+   * * taglines
+   * * urls
+   *
    * 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 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 (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);
     return _response.then((data) => new GetPeopleResponse.fromJson(data));
   }
 
+  /**
+   * Update contact data for an existing contact person. Any non-contact data
+   * will not be modified.
+   *
+   * The request throws a 400 error if `updatePersonFields` is not specified.
+   * <br>
+   * The request throws a 400 error if `person.metadata.sources` is not
+   * specified for the contact to be updated.
+   * <br>
+   * The request throws a 412 error if `person.metadata.sources.etag` is
+   * different than the contact's etag, which indicates the contact has changed
+   * since its data was read. Clients should get the latest person and re-apply
+   * their updates to the latest person.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * [resourceName] - The resource name for the person, assigned by the server.
+   * An ASCII string
+   * with a max length of 27 characters, in the form of `people/<person_id>`.
+   * Value must have pattern "^people/[^/]+$".
+   *
+   * [updatePersonFields] - **Required.** A field mask to restrict which fields
+   * on the person are
+   * updated. Valid values are:
+   *
+   * * addresses
+   * * biographies
+   * * birthdays
+   * * braggingRights
+   * * emailAddresses
+   * * events
+   * * genders
+   * * imClients
+   * * interests
+   * * locales
+   * * names
+   * * nicknames
+   * * occupations
+   * * organizations
+   * * phoneNumbers
+   * * relations
+   * * residences
+   * * skills
+   * * urls
+   *
+   * 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> updateContact(Person request, core.String resourceName, {core.String updatePersonFields}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+    if (resourceName == null) {
+      throw new core.ArgumentError("Parameter resourceName is required.");
+    }
+    if (updatePersonFields != null) {
+      _queryParams["updatePersonFields"] = [updatePersonFields];
+    }
+
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + ':updateContact';
+
+    var _response = _requester.request(_url,
+                                       "PATCH",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Person.fromJson(data));
+  }
+
 }
 
 
 class PeopleConnectionsResourceApi {
   final commons.ApiRequester _requester;
 
   PeopleConnectionsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Provides a list of the authenticated user's contacts merged with any
-   * linked profiles.
+   * connected profiles.
+   * <br>
+   * The request throws a 400 error if 'personFields' is not specified.
    *
    * Request parameters:
    *
    * [resourceName] - The resource name to return connections for. Only
    * `people/me` is valid.
    * 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`.
-   *
-   * [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.
    *
+   * [personFields] - **Required.** A field mask to restrict which fields on
+   * each person are
+   * returned. Valid values are:
+   *
+   * * addresses
+   * * ageRanges
+   * * biographies
+   * * birthdays
+   * * braggingRights
+   * * coverPhotos
+   * * emailAddresses
+   * * events
+   * * genders
+   * * imClients
+   * * interests
+   * * locales
+   * * memberships
+   * * metadata
+   * * names
+   * * nicknames
+   * * occupations
+   * * organizations
+   * * phoneNumbers
+   * * photos
+   * * relations
+   * * relationshipInterests
+   * * relationshipStatuses
+   * * residences
+   * * skills
+   * * taglines
+   * * urls
+   *
    * [sortOrder] - The order in which the connections should be sorted. Defaults
    * to
    * `LAST_MODIFIED_ASCENDING`.
    * Possible string values are:
    * - "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`.
+   *
    * 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 requestMask_includeField, core.int pageSize, core.String syncToken, core.String sortOrder, core.bool requestSyncToken, core.String pageToken}) {
+  async.Future<ListConnectionsResponse> list(core.String resourceName, {core.String syncToken, core.String personFields, core.String sortOrder, core.bool requestSyncToken, core.String pageToken, core.int pageSize, core.String requestMask_includeField}) {
     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 (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (syncToken != null) {
       _queryParams["syncToken"] = [syncToken];
     }
+    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 (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (requestMask_includeField != null) {
+      _queryParams["requestMask.includeField"] = [requestMask_includeField];
+    }
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/connections';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 165 matching lines @@
     if (ageRange != null) {
       _json["ageRange"] = ageRange;
     }
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     return _json;
   }
 }
 
+/** The response to a batch get contact groups request. */
+class BatchGetContactGroupsResponse {
+  /** The list of responses for each requested contact group resource. */
+  core.List<ContactGroupResponse> responses;
+
+  BatchGetContactGroupsResponse();
+
+  BatchGetContactGroupsResponse.fromJson(core.Map _json) {
+    if (_json.containsKey("responses")) {
+      responses = _json["responses"].map((value) => new ContactGroupResponse.fromJson(value)).toList();
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (responses != null) {
+      _json["responses"] = responses.map((value) => (value).toJson()).toList();
+    }
+    return _json;
+  }
+}
+
 /** A person's short biography. */
 class Biography {
   /**
    * The content type of the biography.
    * Possible string values are:
    * - "CONTENT_TYPE_UNSPECIFIED" : Unspecified.
    * - "TEXT_PLAIN" : Plain text.
    * - "TEXT_HTML" : HTML text.
    */
   core.String contentType;
@@ skipping 96 matching lines @@
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
+/** A contact group. */
+class ContactGroup {
+  /**
+   * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
+   * resource. Used for web cache validation.
+   */
+  core.String etag;
+  /**
+   * The read-only name translated and formatted in the viewer's account locale
+   * or the `Accept-Language` HTTP header locale for system groups names.
+   * Group names set by the owner are the same as name.
+   */
+  core.String formattedName;
+  /**
+   * The read-only contact group type.
+   * Possible string values are:
+   * - "GROUP_TYPE_UNSPECIFIED" : Unspecified.
+   * - "USER_CONTACT_GROUP" : User defined contact group.
+   * - "SYSTEM_CONTACT_GROUP" : System defined contact group.
+   */
+  core.String groupType;
+  /**
+   * The total number of contacts in the group irrespective of max members in
+   * specified in the request.
+   */
+  core.int memberCount;
+  /**
+   * The list of contact person resource names that are members of the contact
+   * group. The field is not populated for LIST requests and can only be updated
+   * through the
+   * [ModifyContactGroupMembers](/people/api/rest/v1/contactgroups/members/modify).
+   */
+  core.List<core.String> memberResourceNames;
+  /** Metadata about the contact group. */
+  ContactGroupMetadata metadata;
+  /**
+   * The contact group name set by the group owner or a system provided name
+   * for system groups.
+   */
+  core.String name;
+  /**
+   * The resource name for the contact group, assigned by the server. An ASCII
+   * string, in the form of `contactGroups/<contact_group_id>`.
+   */
+  core.String resourceName;
+
+  ContactGroup();
+
+  ContactGroup.fromJson(core.Map _json) {
+    if (_json.containsKey("etag")) {
+      etag = _json["etag"];
+    }
+    if (_json.containsKey("formattedName")) {
+      formattedName = _json["formattedName"];
+    }
+    if (_json.containsKey("groupType")) {
+      groupType = _json["groupType"];
+    }
+    if (_json.containsKey("memberCount")) {
+      memberCount = _json["memberCount"];
+    }
+    if (_json.containsKey("memberResourceNames")) {
+      memberResourceNames = _json["memberResourceNames"];
+    }
+    if (_json.containsKey("metadata")) {
+      metadata = new ContactGroupMetadata.fromJson(_json["metadata"]);
+    }
+    if (_json.containsKey("name")) {
+      name = _json["name"];
+    }
+    if (_json.containsKey("resourceName")) {
+      resourceName = _json["resourceName"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (etag != null) {
+      _json["etag"] = etag;
+    }
+    if (formattedName != null) {
+      _json["formattedName"] = formattedName;
+    }
+    if (groupType != null) {
+      _json["groupType"] = groupType;
+    }
+    if (memberCount != null) {
+      _json["memberCount"] = memberCount;
+    }
+    if (memberResourceNames != null) {
+      _json["memberResourceNames"] = memberResourceNames;
+    }
+    if (metadata != null) {
+      _json["metadata"] = (metadata).toJson();
+    }
+    if (name != null) {
+      _json["name"] = name;
+    }
+    if (resourceName != null) {
+      _json["resourceName"] = resourceName;
+    }
+    return _json;
+  }
+}
+
 /** A Google contact group membership. */
 class ContactGroupMembership {
   /**
    * The contact group ID for the contact group membership. The contact group
    * ID can be custom or predefined. Possible values include, but are not
    * limited to, the following:
    *
    * *  `myContacts`
    * *  `starred`
    * *  A numerical ID for user-created groups.
@@ skipping 10 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 (contactGroupId != null) {
       _json["contactGroupId"] = contactGroupId;
     }
     return _json;
   }
 }
 
+/** The read-only metadata about a contact group. */
+class ContactGroupMetadata {
+  /**
+   * True if the contact group resource has been deleted. Populated only for
+   * [`ListContactGroups`](/people/api/rest/v1/contactgroups/list) requests
+   * that include a sync token.
+   */
+  core.bool deleted;
+  /** The time the group was last updated. */
+  core.String updateTime;
+
+  ContactGroupMetadata();
+
+  ContactGroupMetadata.fromJson(core.Map _json) {
+    if (_json.containsKey("deleted")) {
+      deleted = _json["deleted"];
+    }
+    if (_json.containsKey("updateTime")) {
+      updateTime = _json["updateTime"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (deleted != null) {
+      _json["deleted"] = deleted;
+    }
+    if (updateTime != null) {
+      _json["updateTime"] = updateTime;
+    }
+    return _json;
+  }
+}
+
+/** The response for a specific contact group. */
+class ContactGroupResponse {
+  /** The contact group. */
+  ContactGroup contactGroup;
+  /** The original requested resource name. */
+  core.String requestedResourceName;
+  /** The status of the response. */
+  Status status;
+
+  ContactGroupResponse();
+
+  ContactGroupResponse.fromJson(core.Map _json) {
+    if (_json.containsKey("contactGroup")) {
+      contactGroup = new ContactGroup.fromJson(_json["contactGroup"]);
+    }
+    if (_json.containsKey("requestedResourceName")) {
+      requestedResourceName = _json["requestedResourceName"];
+    }
+    if (_json.containsKey("status")) {
+      status = new Status.fromJson(_json["status"]);
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (contactGroup != null) {
+      _json["contactGroup"] = (contactGroup).toJson();
+    }
+    if (requestedResourceName != null) {
+      _json["requestedResourceName"] = requestedResourceName;
+    }
+    if (status != null) {
+      _json["status"] = (status).toJson();
+    }
+    return _json;
+  }
+}
+
 /**
  * A person's read-only cover photo. A large image shown on the person's
  * profile page that represents who they are or what they care about.
  */
 class CoverPhoto {
   /**
    * True if the cover photo is the default cover photo;
    * false if the cover photo is a user-provided cover photo.
    */
   core.bool default_;
@@ skipping 24 matching lines @@
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (url != null) {
       _json["url"] = url;
     }
     return _json;
   }
 }
 
+/** A request to create a new contact group. */
+class CreateContactGroupRequest {
+  /** The contact group to create. */
+  ContactGroup contactGroup;
+
+  CreateContactGroupRequest();
+
+  CreateContactGroupRequest.fromJson(core.Map _json) {
+    if (_json.containsKey("contactGroup")) {
+      contactGroup = new ContactGroup.fromJson(_json["contactGroup"]);
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (contactGroup != null) {
+      _json["contactGroup"] = (contactGroup).toJson();
+    }
+    return _json;
+  }
+}
+
 /**
  * Represents a whole calendar date, for example a date of birth. The time
  * of day and time zone are either specified elsewhere or are not
  * significant. The date is relative to the
  * [Proleptic Gregorian
  * Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar).
  * The day may be 0 to represent a year and month where the day is not
  * significant. The year may be 0 to represent a month and day independent
  * of year; for example, anniversary date.
  */
@@ skipping 119 matching lines @@
     if (type != null) {
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
+/**
+ * A generic empty message that you can re-use to avoid defining duplicated
+ * empty messages in your APIs. A typical example is to use it as the request
+ * or the response type of an API method. For instance:
+ *
+ *     service Foo {
+ *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ *     }
+ *
+ * The JSON representation for `Empty` is empty JSON object `{}`.
+ */
+class Empty {
+
+  Empty();
+
+  Empty.fromJson(core.Map _json) {
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    return _json;
+  }
+}
+
 /** An event related to the person. */
 class Event {
   /** The date of the event. */
   Date date;
   /**
    * The read-only type of the event translated and formatted in the
    * viewer's account locale or the `Accept-Language` HTTP header locale.
    */
   core.String formattedType;
   /** Metadata about the event. */
@@ skipping 279 matching lines @@
 class ListConnectionsResponse {
   /** The list of people that the requestor is connected to. */
   core.List<Person> connections;
   /** The token that can be used to retrieve the next page of results. */
   core.String nextPageToken;
   /** The token that can be used to retrieve changes since the last request. */
   core.String nextSyncToken;
   /** The total number of items in the list without pagination. */
   core.int totalItems;
   /**
-   * DEPRECATED(Please use total_items). The total number of people in the list
-   * without pagination.
+   * **DEPRECATED** (Please use totalItems)
+   * The total number of people in the list without pagination.
    */
   core.int totalPeople;
 
   ListConnectionsResponse();
 
   ListConnectionsResponse.fromJson(core.Map _json) {
     if (_json.containsKey("connections")) {
       connections = _json["connections"].map((value) => new Person.fromJson(value)).toList();
     }
     if (_json.containsKey("nextPageToken")) {
@@ skipping 24 matching lines @@
     if (totalItems != null) {
       _json["totalItems"] = totalItems;
     }
     if (totalPeople != null) {
       _json["totalPeople"] = totalPeople;
     }
     return _json;
   }
 }
 
+/** The response to a list contact groups request. */
+class ListContactGroupsResponse {
+  /**
+   * The list of contact groups. Members of the contact groups are not
+   * populated.
+   */
+  core.List<ContactGroup> contactGroups;
+  /** The token that can be used to retrieve the next page of results. */
+  core.String nextPageToken;
+  /** The token that can be used to retrieve changes since the last request. */
+  core.String nextSyncToken;
+  /** The total number of items in the list without pagination. */
+  core.int totalItems;
+
+  ListContactGroupsResponse();
+
+  ListContactGroupsResponse.fromJson(core.Map _json) {
+    if (_json.containsKey("contactGroups")) {
+      contactGroups = _json["contactGroups"].map((value) => new ContactGroup.fromJson(value)).toList();
+    }
+    if (_json.containsKey("nextPageToken")) {
+      nextPageToken = _json["nextPageToken"];
+    }
+    if (_json.containsKey("nextSyncToken")) {
+      nextSyncToken = _json["nextSyncToken"];
+    }
+    if (_json.containsKey("totalItems")) {
+      totalItems = _json["totalItems"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (contactGroups != null) {
+      _json["contactGroups"] = contactGroups.map((value) => (value).toJson()).toList();
+    }
+    if (nextPageToken != null) {
+      _json["nextPageToken"] = nextPageToken;
+    }
+    if (nextSyncToken != null) {
+      _json["nextSyncToken"] = nextSyncToken;
+    }
+    if (totalItems != null) {
+      _json["totalItems"] = totalItems;
+    }
+    return _json;
+  }
+}
+
 /** A person's locale preference. */
 class Locale {
   /** Metadata about the locale. */
   FieldMetadata metadata;
   /**
    * The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
    * language tag representing the locale.
    */
   core.String value;
 
@@ skipping 51 matching lines @@
     if (domainMembership != null) {
       _json["domainMembership"] = (domainMembership).toJson();
     }
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     return _json;
   }
 }
 
+/** A request to modify an existing contact group's members. */
+class ModifyContactGroupMembersRequest {
+  /**
+   * The resource names of the contact people to add in the form of in the form
+   * `people/<person_id>`.
+   */
+  core.List<core.String> resourceNamesToAdd;
+  /**
+   * The resource names of the contact people to remove in the form of in the
+   * form of `people/<person_id>`.
+   */
+  core.List<core.String> resourceNamesToRemove;
+
+  ModifyContactGroupMembersRequest();
+
+  ModifyContactGroupMembersRequest.fromJson(core.Map _json) {
+    if (_json.containsKey("resourceNamesToAdd")) {
+      resourceNamesToAdd = _json["resourceNamesToAdd"];
+    }
+    if (_json.containsKey("resourceNamesToRemove")) {
+      resourceNamesToRemove = _json["resourceNamesToRemove"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (resourceNamesToAdd != null) {
+      _json["resourceNamesToAdd"] = resourceNamesToAdd;
+    }
+    if (resourceNamesToRemove != null) {
+      _json["resourceNamesToRemove"] = resourceNamesToRemove;
+    }
+    return _json;
+  }
+}
+
+/** The response to a modify contact group members request. */
+class ModifyContactGroupMembersResponse {
+  /** The contact people resource names that were not found. */
+  core.List<core.String> notFoundResourceNames;
+
+  ModifyContactGroupMembersResponse();
+
+  ModifyContactGroupMembersResponse.fromJson(core.Map _json) {
+    if (_json.containsKey("notFoundResourceNames")) {
+      notFoundResourceNames = _json["notFoundResourceNames"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (notFoundResourceNames != null) {
+      _json["notFoundResourceNames"] = notFoundResourceNames;
+    }
+    return _json;
+  }
+}
+
 /** A person's name. If the name is a mononym, the family name is empty. */
 class Name {
   /**
    * The read-only display name formatted according to the locale specified by
    * the viewer's account or the <code>Accept-Language</code> HTTP header.
    */
   core.String displayName;
   /**
    * The read-only display name with the last name first formatted according to
    * the locale specified by the viewer's account or the
@@ skipping 351 matching lines @@
  * authenticated user's contacts and profile data.
  *
  * Most fields can have multiple items. The items in a field have no guaranteed
  * order, but each non-empty field is guaranteed to have exactly one field with
  * `metadata.primary` set to true.
  */
 class Person {
   /** The person's street addresses. */
   core.List<Address> addresses;
   /**
-   * DEPRECATED(Please read person.age_ranges instead). The person's age range.
+   * **DEPRECATED** (Please use `person.ageRanges` instead)**
+   *
+   * The person's read-only age range.
    * Possible string values are:
    * - "AGE_RANGE_UNSPECIFIED" : Unspecified.
    * - "LESS_THAN_EIGHTEEN" : Younger than eighteen.
    * - "EIGHTEEN_TO_TWENTY" : Between eighteen and twenty.
    * - "TWENTY_ONE_OR_OLDER" : Twenty-one and older.
    */
   core.String ageRange;
-  /** The person's age ranges. */
+  /** The person's read-only age ranges. */
   core.List<AgeRangeType> ageRanges;
   /** The person's biographies. */
   core.List<Biography> biographies;
   /** The person's birthdays. */
   core.List<Birthday> birthdays;
   /** The person's bragging rights. */
   core.List<BraggingRights> braggingRights;
-  /** The person's cover photos. */
+  /** The person's read-only cover photos. */
   core.List<CoverPhoto> coverPhotos;
   /** The person's email addresses. */
   core.List<EmailAddress> emailAddresses;
   /**
    * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
    * resource. Used for web cache validation.
    */
   core.String etag;
   /** The person's events. */
   core.List<Event> events;
   /** The person's genders. */
   core.List<Gender> genders;
   /** The person's instant messaging clients. */
   core.List<ImClient> imClients;
   /** The person's interests. */
   core.List<Interest> interests;
   /** The person's locale preferences. */
   core.List<Locale> locales;
-  /** The person's group memberships. */
+  /** The person's read-only group memberships. */
   core.List<Membership> memberships;
-  /** Metadata about the person. */
+  /** Read-only metadata about the person. */
   PersonMetadata metadata;
   /** The person's names. */
   core.List<Name> names;
   /** The person's nicknames. */
   core.List<Nickname> nicknames;
   /** The person's occupations. */
   core.List<Occupation> occupations;
   /** The person's past or current organizations. */
   core.List<Organization> organizations;
   /** The person's phone numbers. */
   core.List<PhoneNumber> phoneNumbers;
-  /** The person's photos. */
+  /** The person's read-only photos. */
   core.List<Photo> photos;
   /** The person's relations. */
   core.List<Relation> relations;
-  /** The kind of relationship the person is looking for. */
+  /** The person's read-only relationship interests. */
   core.List<RelationshipInterest> relationshipInterests;
-  /** The person's relationship statuses. */
+  /** The person's read-only relationship statuses. */
   core.List<RelationshipStatus> relationshipStatuses;
   /** The person's residences. */
   core.List<Residence> residences;
   /**
    * The resource name for the person, assigned by the server. An ASCII string
    * with a max length of 27 characters, in the form of `people/<person_id>`.
    */
   core.String resourceName;
   /** The person's skills. */
   core.List<Skill> skills;
-  /** The person's taglines. */
+  /** The person's read-only taglines. */
   core.List<Tagline> taglines;
   /** The person's associated URLs. */
   core.List<Url> urls;
 
   Person();
 
   Person.fromJson(core.Map _json) {
     if (_json.containsKey("addresses")) {
       addresses = _json["addresses"].map((value) => new Address.fromJson(value)).toList();
     }
@@ skipping 186 matching lines @@
 class PersonMetadata {
   /**
    * True if the person resource has been deleted. Populated only for
    * [`connections.list`](/people/api/rest/v1/people.connections/list) requests
    * that include a sync token.
    */
   core.bool deleted;
   /** Resource names of people linked to this resource. */
   core.List<core.String> linkedPeopleResourceNames;
   /**
-   * DEPRECATED(Please read person.metadata.sources.profile_metadata instead).
+   * **DEPRECATED** (Please use
+   * `person.metadata.sources.profileMetadata.objectType` instead)
+   *
    * The type of the person object.
    * Possible string values are:
    * - "OBJECT_TYPE_UNSPECIFIED" : Unspecified.
    * - "PERSON" : Person.
    * - "PAGE" : [Google+ Page.](http://www.google.com/+/brands/)
    */
   core.String objectType;
   /**
    * Any former resource names this person has had. Populated only for
    * [`connections.list`](/people/api/rest/v1/people.connections/list) requests
@@ skipping 44 matching lines @@
     if (sources != null) {
       _json["sources"] = sources.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /** The response for a single person */
 class PersonResponse {
   /**
-   * DEPRECATED(Please use status instead).
-   * [HTTP 1.1 status
-   * code](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
+   * **DEPRECATED** (Please use status instead)
+   *
+   * [HTTP 1.1 status code]
+   * (http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
    */
   core.int httpStatusCode;
   /** The person. */
   Person person;
   /**
    * The original requested resource name. May be different than the resource
    * name on the returned person.
    *
    * The resource name can change when adding or removing fields that link a
    * contact and profile such as a verified email, verified phone number, or a
@@ skipping 41 matching lines @@
 /** A person's phone number. */
 class PhoneNumber {
   /**
    * The read-only canonicalized [ITU-T
    * E.164](https://law.resource.org/pub/us/cfr/ibr/004/itu-t.E.164.1.2008.pdf)
    * form of the phone number.
    */
   core.String canonicalForm;
   /**
    * The read-only type of the phone number translated and formatted in the
-   * viewer's account locale or the the `Accept-Language` HTTP header locale.
+   * viewer's account locale or the `Accept-Language` HTTP header locale.
    */
   core.String formattedType;
   /** Metadata about the phone number. */
   FieldMetadata metadata;
   /**
    * The type of the phone number. The type can be custom or predefined.
    * Possible values include, but are not limited to, the following:
    *
    * * `home`
    * * `work`
@@ skipping 93 matching lines @@
 /** The read-only metadata about a profile. */
 class ProfileMetadata {
   /**
    * The profile object type.
    * Possible string values are:
    * - "OBJECT_TYPE_UNSPECIFIED" : Unspecified.
    * - "PERSON" : Person.
    * - "PAGE" : [Google+ Page.](http://www.google.com/+/brands/)
    */
   core.String objectType;
+  /** The user types. */
+  core.List<core.String> userTypes;
 
   ProfileMetadata();
 
   ProfileMetadata.fromJson(core.Map _json) {
     if (_json.containsKey("objectType")) {
       objectType = _json["objectType"];
     }
+    if (_json.containsKey("userTypes")) {
+      userTypes = _json["userTypes"];
+    }
   }
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (objectType != null) {
       _json["objectType"] = objectType;
     }
+    if (userTypes != null) {
+      _json["userTypes"] = userTypes;
+    }
     return _json;
   }
 }
 
 /** A person's relation to another person. */
 class Relation {
   /**
    * The type of the relation translated and formatted in the viewer's account
    * locale or the locale specified in the Accept-Language HTTP header.
    */
@@ skipping 247 matching lines @@
   core.String id;
   /** Metadata about a source of type PROFILE. */
   ProfileMetadata profileMetadata;
   /**
    * The source type.
    * Possible string values are:
    * - "SOURCE_TYPE_UNSPECIFIED" : Unspecified.
    * - "ACCOUNT" : [Google Account](https://accounts.google.com).
    * - "PROFILE" : [Google profile](https://profiles.google.com). You can view
    * the
-   * profile at https://profiles.google.com/<id> where <id> is the source
-   * id.
+   * profile at https://profiles.google.com/<var>id</var> where
+   * <var>id</var> is the source id.
    * - "DOMAIN_PROFILE" : [Google Apps domain
    * profile](https://admin.google.com).
    * - "CONTACT" : [Google contact](https://contacts.google.com). You can view
    * the
-   * contact at https://contact.google.com/<id> where <id> is the source
-   * id.
+   * contact at https://contact.google.com/<var>id</var> where <var>id</var>
+   * is the source id.
    */
   core.String type;
+  /** Last update timestamp of this source. */
+  core.String updateTime;
 
   Source();
 
   Source.fromJson(core.Map _json) {
     if (_json.containsKey("etag")) {
       etag = _json["etag"];
     }
     if (_json.containsKey("id")) {
       id = _json["id"];
     }
     if (_json.containsKey("profileMetadata")) {
       profileMetadata = new ProfileMetadata.fromJson(_json["profileMetadata"]);
     }
     if (_json.containsKey("type")) {
       type = _json["type"];
     }
+    if (_json.containsKey("updateTime")) {
+      updateTime = _json["updateTime"];
+    }
   }
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (etag != null) {
       _json["etag"] = etag;
     }
     if (id != null) {
       _json["id"] = id;
     }
     if (profileMetadata != null) {
       _json["profileMetadata"] = (profileMetadata).toJson();
     }
     if (type != null) {
       _json["type"] = type;
     }
+    if (updateTime != null) {
+      _json["updateTime"] = updateTime;
+    }
     return _json;
   }
 }
 
 /**
  * The `Status` type defines a logical error model that is suitable for
  * different
  * programming environments, including REST APIs and RPC APIs. It is used by
  * [gRPC](https://github.com/grpc). The error model is designed to be:
  *
@@ skipping 44 matching lines @@
  *     results in its response, the status of those operations should be
  *     represented directly using the `Status` message.
  *
  * - Logging. If some API errors are stored in logs, the message `Status` could
  * be used directly after any stripping needed for security/privacy reasons.
  */
 class Status {
   /** The status code, which should be an enum value of google.rpc.Code. */
   core.int code;
   /**
-   * A list of messages that carry the error details.  There will be a
-   * common set of message types for APIs to use.
+   * A list of messages that carry the error details.  There is a common set of
+   * message types for APIs to use.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
    */
   core.List<core.Map<core.String, core.Object>> details;
   /**
    * A developer-facing error message, which should be in English. Any
    * user-facing error message should be localized and sent in the
    * google.rpc.Status.details field, or localized by the client.
    */
@@ skipping 51 matching lines @@
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
+/**
+ * A request to update an existing contact group. Only the name can be updated.
+ */
+class UpdateContactGroupRequest {
+  /** The contact group to update. */
+  ContactGroup contactGroup;
+
+  UpdateContactGroupRequest();
+
+  UpdateContactGroupRequest.fromJson(core.Map _json) {
+    if (_json.containsKey("contactGroup")) {
+      contactGroup = new ContactGroup.fromJson(_json["contactGroup"]);
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    if (contactGroup != null) {
+      _json["contactGroup"] = (contactGroup).toJson();
+    }
+    return _json;
+  }
+}
+
 /** A person's associated URLs. */
 class Url {
   /**
    * The read-only type of the URL translated and formatted in the viewer's
    * account locale or the `Accept-Language` HTTP header locale.
    */
   core.String formattedType;
   /** Metadata about the URL. */
   FieldMetadata metadata;
   /**
@@ skipping 41 matching lines @@
     }
     if (type != null) {
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }