Api-Roll 54: 2017-09-11

generated/googleapis/lib/people/v1.dart

Index: generated/googleapis/lib/people/v1.dart
diff --git a/generated/googleapis/lib/people/v1.dart b/generated/googleapis/lib/people/v1.dart
index 201a9c887af30a64fe299d1119bd0250c091091a..cc05c1664657ba93c758d6cdf2b2fe6e2961f541 100644
--- a/generated/googleapis/lib/people/v1.dart
+++ b/generated/googleapis/lib/people/v1.dart
@@ -9,79 +9,88 @@ import 'dart:convert' as convert;
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
 
-export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
-    ApiRequestError, DetailedApiRequestError;
+export 'package:_discoveryapis_commons/_discoveryapis_commons.dart'
+    show ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client people/v1';
 
-/** Provides access to information about profiles and contacts. */
+/// Provides access to information about profiles and contacts.
 class PeopleApi {
-  /** Manage your contacts */
+  /// Manage your contacts
   static const ContactsScope = "https://www.googleapis.com/auth/contacts";
 
-  /** View your contacts */
-  static const ContactsReadonlyScope = "https://www.googleapis.com/auth/contacts.readonly";
+  /// View your contacts
+  static const ContactsReadonlyScope =
+      "https://www.googleapis.com/auth/contacts.readonly";
 
-  /** Know the list of people in your circles, your age range, and language */
+  /// Know the list of people in your circles, your age range, and language
   static const PlusLoginScope = "https://www.googleapis.com/auth/plus.login";
 
-  /** View your street addresses */
-  static const UserAddressesReadScope = "https://www.googleapis.com/auth/user.addresses.read";
+  /// View your street addresses
+  static const UserAddressesReadScope =
+      "https://www.googleapis.com/auth/user.addresses.read";
 
-  /** View your complete date of birth */
-  static const UserBirthdayReadScope = "https://www.googleapis.com/auth/user.birthday.read";
+  /// View your complete date of birth
+  static const UserBirthdayReadScope =
+      "https://www.googleapis.com/auth/user.birthday.read";
 
-  /** View your email addresses */
-  static const UserEmailsReadScope = "https://www.googleapis.com/auth/user.emails.read";
+  /// View your email addresses
+  static const UserEmailsReadScope =
+      "https://www.googleapis.com/auth/user.emails.read";
 
-  /** View your phone numbers */
-  static const UserPhonenumbersReadScope = "https://www.googleapis.com/auth/user.phonenumbers.read";
+  /// View your phone numbers
+  static const UserPhonenumbersReadScope =
+      "https://www.googleapis.com/auth/user.phonenumbers.read";
 
-  /** 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";
+  /// 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);
+  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);
+  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}) {
+  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;
@@ -98,31 +107,29 @@ class ContactGroupsResourceApi {
 
     _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.
-   */
+    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();
@@ -137,37 +144,35 @@ class ContactGroupsResourceApi {
 
     _url = 'v1/contactGroups';
 
-    var _response = _requester.request(_url,
-                                       "POST",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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}) {
+  /// 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;
@@ -184,36 +189,35 @@ class ContactGroupsResourceApi {
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName');
 
-    var _response = _requester.request(_url,
-                                       "DELETE",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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}) {
+  /// 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;
@@ -230,41 +234,39 @@ class ContactGroupsResourceApi {
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName');
 
-    var _response = _requester.request(_url,
-                                       "GET",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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:
-   *
-   * [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.
-   *
-   * 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 pageToken, core.int pageSize, core.String syncToken}) {
+  /// 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;
@@ -272,50 +274,49 @@ class ContactGroupsResourceApi {
     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}"];
     }
-    if (syncToken != null) {
-      _queryParams["syncToken"] = [syncToken];
-    }
 
     _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/`<var>contact_group_id</var>.
-   * 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 _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/`<var>contact_group_id</var>.
+  /// 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;
@@ -332,44 +333,40 @@ class ContactGroupsResourceApi {
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName');
 
-    var _response = _requester.request(_url,
-                                       "PUT",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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) {
+  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;
@@ -384,46 +381,44 @@ class ContactGroupsMembersResourceApi {
       throw new core.ArgumentError("Parameter resourceName is required.");
     }
 
-    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/members:modify';
+    _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));
+    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;
-
-  /**
-   * 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.
-   */
+  PeopleConnectionsResourceApi get connections =>
+      new PeopleConnectionsResourceApi(_requester);
+
+  PeopleResourceApi(commons.ApiRequester client) : _requester = client;
+
+  /// 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();
@@ -441,32 +436,29 @@ class PeopleResourceApi {
 
     _url = 'v1/people:createContact';
 
-    var _response = _requester.request(_url,
-                                       "POST",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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.
-   */
+  /// 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();
@@ -479,83 +471,83 @@ class PeopleResourceApi {
       throw new core.ArgumentError("Parameter resourceName is required.");
     }
 
-    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + ':deleteContact';
+    _url = 'v1/' +
+        commons.Escaper.ecapeVariableReserved('$resourceName') +
+        ':deleteContact';
 
-    var _response = _requester.request(_url,
-                                       "DELETE",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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 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
-   * * emailAddresses
-   * * events
-   * * genders
-   * * imClients
-   * * interests
-   * * locales
-   * * memberships
-   * * metadata
-   * * names
-   * * nicknames
-   * * occupations
-   * * organizations
-   * * phoneNumbers
-   * * photos
-   * * relations
-   * * relationshipInterests
-   * * relationshipStatuses
-   * * residences
-   * * skills
-   * * taglines
-   * * 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> get(core.String resourceName, {core.String requestMask_includeField, core.String personFields}) {
+  /// 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 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/[^/]+$".
+  ///
+  /// [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 personFields, core.String requestMask_includeField}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -566,92 +558,93 @@ class PeopleResourceApi {
     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);
+    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
-   * * 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, core.String personFields}) {
+  /// 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:
+  ///
+  /// [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
+  ///
+  /// [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}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -659,85 +652,85 @@ class PeopleResourceApi {
     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);
+    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/`<var>person_id</var>.
-   * 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}) {
+  /// 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/`<var>person_id</var>.
+  /// 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;
@@ -755,107 +748,111 @@ class PeopleResourceApi {
       _queryParams["updatePersonFields"] = [updatePersonFields];
     }
 
-    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + ':updateContact';
+    _url = 'v1/' +
+        commons.Escaper.ecapeVariableReserved('$resourceName') +
+        ':updateContact';
 
-    var _response = _requester.request(_url,
-                                       "PATCH",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    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
-   * 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/[^/]+$".
-   *
-   * [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.
-   *
-   * [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.String requestMask_includeField, core.int pageSize, core.String syncToken}) {
+  PeopleConnectionsResourceApi(commons.ApiRequester client)
+      : _requester = client;
+
+  /// Provides a list of the authenticated user's contacts merged with any
+  /// 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/[^/]+$".
+  ///
+  /// [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`.
+  ///
+  /// [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
+  ///
+  /// 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 sortOrder,
+      core.bool requestSyncToken,
+      core.String pageToken,
+      core.int pageSize,
+      core.String requestMask_includeField,
+      core.String syncToken,
+      core.String personFields}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -866,9 +863,6 @@ class PeopleConnectionsResourceApi {
     if (resourceName == null) {
       throw new core.ArgumentError("Parameter resourceName is required.");
     }
-    if (personFields != null) {
-      _queryParams["personFields"] = [personFields];
-    }
     if (sortOrder != null) {
       _queryParams["sortOrder"] = [sortOrder];
     }
@@ -878,78 +872,81 @@ class PeopleConnectionsResourceApi {
     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];
     }
+    if (personFields != null) {
+      _queryParams["personFields"] = [personFields];
+    }
 
-    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/connections';
+    _url = 'v1/' +
+        commons.Escaper.ecapeVariableReserved('$resourceName') +
+        '/connections';
 
-    var _response = _requester.request(_url,
-                                       "GET",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    var _response = _requester.request(_url, "GET",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListConnectionsResponse.fromJson(data));
   }
-
 }
 
-
-
-/**
- * A person's physical address. May be a P.O. box or street address. All fields
- * are optional.
- */
+/// A person's physical address. May be a P.O. box or street address. All
+/// fields
+/// are optional.
 class Address {
-  /** The city of the address. */
+  /// The city of the address.
   core.String city;
-  /** The country of the address. */
+
+  /// The country of the address.
   core.String country;
-  /**
-   * The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm) country
-   * code of the address.
-   */
+
+  /// The [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes.htm)
+  /// country
+  /// code of the address.
   core.String countryCode;
-  /**
-   * The extended address of the address; for example, the apartment number.
-   */
+
+  /// The extended address of the address; for example, the apartment number.
   core.String extendedAddress;
-  /**
-   * The read-only type of the address translated and formatted in the viewer's
-   * account locale or the `Accept-Language` HTTP header locale.
-   */
+
+  /// The read-only type of the address translated and formatted in the
+  /// viewer's
+  /// account locale or the `Accept-Language` HTTP header locale.
   core.String formattedType;
-  /**
-   * The unstructured value of the address. If this is not set by the user it
-   * will be automatically constructed from structured values.
-   */
+
+  /// The unstructured value of the address. If this is not set by the user it
+  /// will be automatically constructed from structured values.
   core.String formattedValue;
-  /** Metadata about the address. */
+
+  /// Metadata about the address.
   FieldMetadata metadata;
-  /** The P.O. box of the address. */
+
+  /// The P.O. box of the address.
   core.String poBox;
-  /** The postal code of the address. */
+
+  /// The postal code of the address.
   core.String postalCode;
-  /** The region of the address; for example, the state or province. */
+
+  /// The region of the address; for example, the state or province.
   core.String region;
-  /** The street address. */
+
+  /// The street address.
   core.String streetAddress;
-  /**
-   * The type of the address. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `home`
-   * * `work`
-   * * `other`
-   */
+
+  /// The type of the address. The type can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `home`
+  /// * `work`
+  /// * `other`
   core.String type;
 
   Address();
@@ -994,7 +991,8 @@ class Address {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (city != null) {
       _json["city"] = city;
     }
@@ -1035,18 +1033,17 @@ class Address {
   }
 }
 
-/** A person's age range. */
+/// A person's age range.
 class AgeRangeType {
-  /**
-   * The 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.
-   */
+  /// The 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;
-  /** Metadata about the age range. */
+
+  /// Metadata about the age range.
   FieldMetadata metadata;
 
   AgeRangeType();
@@ -1061,7 +1058,8 @@ class AgeRangeType {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (ageRange != null) {
       _json["ageRange"] = ageRange;
     }
@@ -1072,21 +1070,24 @@ class AgeRangeType {
   }
 }
 
-/** The response to a batch get contact groups request. */
+/// The response to a batch get contact groups request.
 class BatchGetContactGroupsResponse {
-  /** The list of responses for each requested contact group resource. */
+  /// 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();
+      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>();
+    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();
     }
@@ -1094,19 +1095,19 @@ class BatchGetContactGroupsResponse {
   }
 }
 
-/** A person's short biography. */
+/// 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.
-   */
+  /// 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;
-  /** Metadata about the biography. */
+
+  /// Metadata about the biography.
   FieldMetadata metadata;
-  /** The short biography. */
+
+  /// The short biography.
   core.String value;
 
   Biography();
@@ -1124,7 +1125,8 @@ class Biography {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (contentType != null) {
       _json["contentType"] = contentType;
     }
@@ -1138,17 +1140,17 @@ class Biography {
   }
 }
 
-/**
- * A person's birthday. At least one of the `date` and `text` fields are
- * specified. The `date` and `text` fields typically represent the same
- * date, but are not guaranteed to.
- */
+/// A person's birthday. At least one of the `date` and `text` fields are
+/// specified. The `date` and `text` fields typically represent the same
+/// date, but are not guaranteed to.
 class Birthday {
-  /** The date of the birthday. */
+  /// The date of the birthday.
   Date date;
-  /** Metadata about the birthday. */
+
+  /// Metadata about the birthday.
   FieldMetadata metadata;
-  /** A free-form string representing the user's birthday. */
+
+  /// A free-form string representing the user's birthday.
   core.String text;
 
   Birthday();
@@ -1166,7 +1168,8 @@ class Birthday {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (date != null) {
       _json["date"] = (date).toJson();
     }
@@ -1180,11 +1183,12 @@ class Birthday {
   }
 }
 
-/** A person's bragging rights. */
+/// A person's bragging rights.
 class BraggingRights {
-  /** Metadata about the bragging rights. */
+  /// Metadata about the bragging rights.
   FieldMetadata metadata;
-  /** The bragging rights; for example, `climbed mount everest`. */
+
+  /// The bragging rights; for example, `climbed mount everest`.
   core.String value;
 
   BraggingRights();
@@ -1199,7 +1203,8 @@ class BraggingRights {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -1210,50 +1215,45 @@ class BraggingRights {
   }
 }
 
-/** A contact group. */
+/// A contact group.
 class ContactGroup {
-  /**
-   * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
-   * resource. Used for web cache validation.
-   */
+  /// 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.
-   */
+
+  /// 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.
-   */
+
+  /// 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.
-   */
+
+  /// 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).
-   */
+
+  /// 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. */
+
+  /// Metadata about the contact group.
   ContactGroupMetadata metadata;
-  /**
-   * The contact group name set by the group owner or a system provided name
-   * for system groups.
-   */
+
+  /// 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/`<var>contact_group_id</var>.
-   */
+
+  /// The resource name for the contact group, assigned by the server. An ASCII
+  /// string, in the form of `contactGroups/`<var>contact_group_id</var>.
   core.String resourceName;
 
   ContactGroup();
@@ -1286,7 +1286,8 @@ class ContactGroup {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (etag != null) {
       _json["etag"] = etag;
     }
@@ -1315,17 +1316,15 @@ class ContactGroup {
   }
 }
 
-/** A Google contact group membership. */
+/// 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.
-   */
+  /// 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.
   core.String contactGroupId;
 
   ContactGroupMembership();
@@ -1337,7 +1336,8 @@ class ContactGroupMembership {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (contactGroupId != null) {
       _json["contactGroupId"] = contactGroupId;
     }
@@ -1345,15 +1345,14 @@ class ContactGroupMembership {
   }
 }
 
-/** The read-only metadata about a contact group. */
+/// 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.
-   */
+  /// 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. */
+
+  /// The time the group was last updated.
   core.String updateTime;
 
   ContactGroupMetadata();
@@ -1368,7 +1367,8 @@ class ContactGroupMetadata {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (deleted != null) {
       _json["deleted"] = deleted;
     }
@@ -1379,13 +1379,15 @@ class ContactGroupMetadata {
   }
 }
 
-/** The response for a specific contact group. */
+/// The response for a specific contact group.
 class ContactGroupResponse {
-  /** The contact group. */
+  /// The contact group.
   ContactGroup contactGroup;
-  /** The original requested resource name. */
+
+  /// The original requested resource name.
   core.String requestedResourceName;
-  /** The status of the response. */
+
+  /// The status of the response.
   Status status;
 
   ContactGroupResponse();
@@ -1403,7 +1405,8 @@ class ContactGroupResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (contactGroup != null) {
       _json["contactGroup"] = (contactGroup).toJson();
     }
@@ -1417,19 +1420,17 @@ class ContactGroupResponse {
   }
 }
 
-/**
- * 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.
- */
+/// 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.
-   */
+  /// True if the cover photo is the default cover photo;
+  /// false if the cover photo is a user-provided cover photo.
   core.bool default_;
-  /** Metadata about the cover photo. */
+
+  /// Metadata about the cover photo.
   FieldMetadata metadata;
-  /** The URL of the cover photo. */
+
+  /// The URL of the cover photo.
   core.String url;
 
   CoverPhoto();
@@ -1447,7 +1448,8 @@ class CoverPhoto {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (default_ != null) {
       _json["default"] = default_;
     }
@@ -1461,9 +1463,9 @@ class CoverPhoto {
   }
 }
 
-/** A request to create a new contact group. */
+/// A request to create a new contact group.
 class CreateContactGroupRequest {
-  /** The contact group to create. */
+  /// The contact group to create.
   ContactGroup contactGroup;
 
   CreateContactGroupRequest();
@@ -1475,7 +1477,8 @@ class CreateContactGroupRequest {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (contactGroup != null) {
       _json["contactGroup"] = (contactGroup).toJson();
     }
@@ -1483,28 +1486,24 @@ class CreateContactGroupRequest {
   }
 }
 
-/**
- * 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.
- */
+/// 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.
 class Date {
-  /**
-   * Day of month. Must be from 1 to 31 and valid for the year and month, or 0
-   * if specifying a year/month where the day is not significant.
-   */
+  /// Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+  /// if specifying a year/month where the day is not significant.
   core.int day;
-  /** Month of year. Must be from 1 to 12. */
+
+  /// Month of year. Must be from 1 to 12.
   core.int month;
-  /**
-   * Year of date. Must be from 1 to 9999, or 0 if specifying a date without
-   * a year.
-   */
+
+  /// Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+  /// a year.
   core.int year;
 
   Date();
@@ -1522,7 +1521,8 @@ class Date {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (day != null) {
       _json["day"] = day;
     }
@@ -1536,9 +1536,9 @@ class Date {
   }
 }
 
-/** A Google Apps Domain membership. */
+/// A Google Apps Domain membership.
 class DomainMembership {
-  /** True if the person is in the viewer's Google Apps domain. */
+  /// True if the person is in the viewer's Google Apps domain.
   core.bool inViewerDomain;
 
   DomainMembership();
@@ -1550,7 +1550,8 @@ class DomainMembership {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (inViewerDomain != null) {
       _json["inViewerDomain"] = inViewerDomain;
     }
@@ -1558,27 +1559,27 @@ class DomainMembership {
   }
 }
 
-/** A person's email address. */
+/// A person's email address.
 class EmailAddress {
-  /** The display name of the email. */
+  /// The display name of the email.
   core.String displayName;
-  /**
-   * The read-only type of the email address translated and formatted in the
-   * viewer's account locale or the `Accept-Language` HTTP header locale.
-   */
+
+  /// The read-only type of the email address translated and formatted in the
+  /// viewer's account locale or the `Accept-Language` HTTP header locale.
   core.String formattedType;
-  /** Metadata about the email address. */
+
+  /// Metadata about the email address.
   FieldMetadata metadata;
-  /**
-   * The type of the email address. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `home`
-   * * `work`
-   * * `other`
-   */
+
+  /// The type of the email address. The type can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `home`
+  /// * `work`
+  /// * `other`
   core.String type;
-  /** The email address. */
+
+  /// The email address.
   core.String value;
 
   EmailAddress();
@@ -1602,7 +1603,8 @@ class EmailAddress {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (displayName != null) {
       _json["displayName"] = displayName;
     }
@@ -1622,48 +1624,44 @@ class EmailAddress {
   }
 }
 
-/**
- * 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 `{}`.
- */
+/// 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) {
-  }
+  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>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     return _json;
   }
 }
 
-/** An event related to the person. */
+/// An event related to the person.
 class Event {
-  /** The date of the 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.
-   */
+
+  /// 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. */
+
+  /// Metadata about the event.
   FieldMetadata metadata;
-  /**
-   * The type of the event. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `anniversary`
-   * * `other`
-   */
+
+  /// The type of the event. The type can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `anniversary`
+  /// * `other`
   core.String type;
 
   Event();
@@ -1684,7 +1682,8 @@ class Event {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (date != null) {
       _json["date"] = (date).toJson();
     }
@@ -1701,20 +1700,18 @@ class Event {
   }
 }
 
-/** Metadata about a field. */
+/// Metadata about a field.
 class FieldMetadata {
-  /**
-   * True if the field is the primary field; false if the field is a secondary
-   * field.
-   */
+  /// True if the field is the primary field; false if the field is a secondary
+  /// field.
   core.bool primary;
-  /** The source of the field. */
+
+  /// The source of the field.
   Source source;
-  /**
-   * True if the field is verified; false if the field is unverified. A
-   * verified field is typically a name, email address, phone number, or
-   * website that has been confirmed to be owned by the person.
-   */
+
+  /// True if the field is verified; false if the field is unverified. A
+  /// verified field is typically a name, email address, phone number, or
+  /// website that has been confirmed to be owned by the person.
   core.bool verified;
 
   FieldMetadata();
@@ -1732,7 +1729,8 @@ class FieldMetadata {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (primary != null) {
       _json["primary"] = primary;
     }
@@ -1746,25 +1744,24 @@ class FieldMetadata {
   }
 }
 
-/** A person's gender. */
+/// A person's gender.
 class Gender {
-  /**
-   * The read-only value of the gender translated and formatted in the viewer's
-   * account locale or the `Accept-Language` HTTP header locale.
-   */
+  /// The read-only value of the gender translated and formatted in the
+  /// viewer's
+  /// account locale or the `Accept-Language` HTTP header locale.
   core.String formattedValue;
-  /** Metadata about the gender. */
+
+  /// Metadata about the gender.
   FieldMetadata metadata;
-  /**
-   * The gender for the person. The gender can be custom or predefined.
-   * Possible values include, but are not limited to, the
-   * following:
-   *
-   * * `male`
-   * * `female`
-   * * `other`
-   * * `unknown`
-   */
+
+  /// The gender for the person. The gender can be custom or predefined.
+  /// Possible values include, but are not limited to, the
+  /// following:
+  ///
+  /// * `male`
+  /// * `female`
+  /// * `other`
+  /// * `unknown`
   core.String value;
 
   Gender();
@@ -1782,7 +1779,8 @@ class Gender {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (formattedValue != null) {
       _json["formattedValue"] = formattedValue;
     }
@@ -1797,19 +1795,22 @@ class Gender {
 }
 
 class GetPeopleResponse {
-  /** The response for each requested resource name. */
+  /// The response for each requested resource name.
   core.List<PersonResponse> responses;
 
   GetPeopleResponse();
 
   GetPeopleResponse.fromJson(core.Map _json) {
     if (_json.containsKey("responses")) {
-      responses = _json["responses"].map((value) => new PersonResponse.fromJson(value)).toList();
+      responses = _json["responses"]
+          .map((value) => new PersonResponse.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>();
+    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();
     }
@@ -1817,45 +1818,42 @@ class GetPeopleResponse {
   }
 }
 
-/** A person's instant messaging client. */
+/// A person's instant messaging client.
 class ImClient {
-  /**
-   * The read-only protocol of the IM client formatted in the viewer's account
-   * locale or the `Accept-Language` HTTP header locale.
-   */
+  /// The read-only protocol of the IM client formatted in the viewer's account
+  /// locale or the `Accept-Language` HTTP header locale.
   core.String formattedProtocol;
-  /**
-   * The read-only type of the IM client translated and formatted in the
-   * viewer's account locale or the `Accept-Language` HTTP header locale.
-   */
+
+  /// The read-only type of the IM client translated and formatted in the
+  /// viewer's account locale or the `Accept-Language` HTTP header locale.
   core.String formattedType;
-  /** Metadata about the IM client. */
+
+  /// Metadata about the IM client.
   FieldMetadata metadata;
-  /**
-   * The protocol of the IM client. The protocol can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `aim`
-   * * `msn`
-   * * `yahoo`
-   * * `skype`
-   * * `qq`
-   * * `googleTalk`
-   * * `icq`
-   * * `jabber`
-   * * `netMeeting`
-   */
+
+  /// The protocol of the IM client. The protocol can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `aim`
+  /// * `msn`
+  /// * `yahoo`
+  /// * `skype`
+  /// * `qq`
+  /// * `googleTalk`
+  /// * `icq`
+  /// * `jabber`
+  /// * `netMeeting`
   core.String protocol;
-  /**
-   * The type of the IM client. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `home`
-   * * `work`
-   * * `other`
-   */
+
+  /// The type of the IM client. The type can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `home`
+  /// * `work`
+  /// * `other`
   core.String type;
-  /** The user name used in the IM client. */
+
+  /// The user name used in the IM client.
   core.String username;
 
   ImClient();
@@ -1882,7 +1880,8 @@ class ImClient {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (formattedProtocol != null) {
       _json["formattedProtocol"] = formattedProtocol;
     }
@@ -1905,11 +1904,12 @@ class ImClient {
   }
 }
 
-/** One of the person's interests. */
+/// One of the person's interests.
 class Interest {
-  /** Metadata about the interest. */
+  /// Metadata about the interest.
   FieldMetadata metadata;
-  /** The interest; for example, `stargazing`. */
+
+  /// The interest; for example, `stargazing`.
   core.String value;
 
   Interest();
@@ -1924,7 +1924,8 @@ class Interest {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -1936,25 +1937,29 @@ class Interest {
 }
 
 class ListConnectionsResponse {
-  /** The list of people that the requestor is connected to. */
+  /// 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. */
+
+  /// 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. */
+
+  /// 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. */
+
+  /// The total number of items in the list without pagination.
   core.int totalItems;
-  /**
-   * **DEPRECATED** (Please use totalItems)
-   * 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();
+      connections = _json["connections"]
+          .map((value) => new Person.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ -1971,9 +1976,11 @@ class ListConnectionsResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (connections != null) {
-      _json["connections"] = connections.map((value) => (value).toJson()).toList();
+      _json["connections"] =
+          connections.map((value) => (value).toJson()).toList();
     }
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
@@ -1991,25 +1998,28 @@ class ListConnectionsResponse {
   }
 }
 
-/** The response to a list contact groups request. */
+/// The response to a list contact groups request.
 class ListContactGroupsResponse {
-  /**
-   * The list of contact groups. Members of the contact groups are not
-   * populated.
-   */
+  /// 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. */
+
+  /// 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. */
+
+  /// 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. */
+
+  /// 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();
+      contactGroups = _json["contactGroups"]
+          .map((value) => new ContactGroup.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ -2023,9 +2033,11 @@ class ListContactGroupsResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    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();
+      _json["contactGroups"] =
+          contactGroups.map((value) => (value).toJson()).toList();
     }
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
@@ -2040,14 +2052,13 @@ class ListContactGroupsResponse {
   }
 }
 
-/** A person's locale preference. */
+/// A person's locale preference.
 class Locale {
-  /** Metadata about the locale. */
+  /// Metadata about the locale.
   FieldMetadata metadata;
-  /**
-   * The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
-   * language tag representing the locale.
-   */
+
+  /// The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
+  /// language tag representing the locale.
   core.String value;
 
   Locale();
@@ -2062,7 +2073,8 @@ class Locale {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -2073,23 +2085,27 @@ class Locale {
   }
 }
 
-/** A person's read-only membership in a group. */
+/// A person's read-only membership in a group.
 class Membership {
-  /** The contact group membership. */
+  /// The contact group membership.
   ContactGroupMembership contactGroupMembership;
-  /** The domain membership. */
+
+  /// The domain membership.
   DomainMembership domainMembership;
-  /** Metadata about the membership. */
+
+  /// Metadata about the membership.
   FieldMetadata metadata;
 
   Membership();
 
   Membership.fromJson(core.Map _json) {
     if (_json.containsKey("contactGroupMembership")) {
-      contactGroupMembership = new ContactGroupMembership.fromJson(_json["contactGroupMembership"]);
+      contactGroupMembership =
+          new ContactGroupMembership.fromJson(_json["contactGroupMembership"]);
     }
     if (_json.containsKey("domainMembership")) {
-      domainMembership = new DomainMembership.fromJson(_json["domainMembership"]);
+      domainMembership =
+          new DomainMembership.fromJson(_json["domainMembership"]);
     }
     if (_json.containsKey("metadata")) {
       metadata = new FieldMetadata.fromJson(_json["metadata"]);
@@ -2097,7 +2113,8 @@ class Membership {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (contactGroupMembership != null) {
       _json["contactGroupMembership"] = (contactGroupMembership).toJson();
     }
@@ -2111,17 +2128,15 @@ class Membership {
   }
 }
 
-/** A request to modify an existing contact group's members. */
+/// 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/`<var>person_id</var>.
-   */
+  /// The resource names of the contact people to add in the form of in the
+  /// form
+  /// `people/`<var>person_id</var>.
   core.List<core.String> resourceNamesToAdd;
-  /**
-   * The resource names of the contact people to remove in the form of in the
-   * form of `people/`<var>person_id</var>.
-   */
+
+  /// The resource names of the contact people to remove in the form of in the
+  /// form of `people/`<var>person_id</var>.
   core.List<core.String> resourceNamesToRemove;
 
   ModifyContactGroupMembersRequest();
@@ -2136,7 +2151,8 @@ class ModifyContactGroupMembersRequest {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (resourceNamesToAdd != null) {
       _json["resourceNamesToAdd"] = resourceNamesToAdd;
     }
@@ -2147,9 +2163,9 @@ class ModifyContactGroupMembersRequest {
   }
 }
 
-/** The response to a modify contact group members request. */
+/// The response to a modify contact group members request.
 class ModifyContactGroupMembersResponse {
-  /** The contact people resource names that were not found. */
+  /// The contact people resource names that were not found.
   core.List<core.String> notFoundResourceNames;
 
   ModifyContactGroupMembersResponse();
@@ -2161,7 +2177,8 @@ class ModifyContactGroupMembersResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (notFoundResourceNames != null) {
       _json["notFoundResourceNames"] = notFoundResourceNames;
     }
@@ -2169,42 +2186,52 @@ class ModifyContactGroupMembersResponse {
   }
 }
 
-/** A person's name. If the name is a mononym, the family name is empty. */
+/// 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 `Accept-Language` HTTP header.
-   */
+  /// The read-only display name formatted according to the locale specified by
+  /// the viewer's account or the `Accept-Language` 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
-   * `Accept-Language` HTTP header.
-   */
+
+  /// The read-only display name with the last name first formatted according
+  /// to
+  /// the locale specified by the viewer's account or the
+  /// `Accept-Language` HTTP header.
   core.String displayNameLastFirst;
-  /** The family name. */
+
+  /// The family name.
   core.String familyName;
-  /** The given name. */
+
+  /// The given name.
   core.String givenName;
-  /** The honorific prefixes, such as `Mrs.` or `Dr.` */
+
+  /// The honorific prefixes, such as `Mrs.` or `Dr.`
   core.String honorificPrefix;
-  /** The honorific suffixes, such as `Jr.` */
+
+  /// The honorific suffixes, such as `Jr.`
   core.String honorificSuffix;
-  /** Metadata about the name. */
+
+  /// Metadata about the name.
   FieldMetadata metadata;
-  /** The middle name(s). */
+
+  /// The middle name(s).
   core.String middleName;
-  /** The family name spelled as it sounds. */
+
+  /// The family name spelled as it sounds.
   core.String phoneticFamilyName;
-  /** The full name spelled as it sounds. */
+
+  /// The full name spelled as it sounds.
   core.String phoneticFullName;
-  /** The given name spelled as it sounds. */
+
+  /// The given name spelled as it sounds.
   core.String phoneticGivenName;
-  /** The honorific prefixes spelled as they sound. */
+
+  /// The honorific prefixes spelled as they sound.
   core.String phoneticHonorificPrefix;
-  /** The honorific suffixes spelled as they sound. */
+
+  /// The honorific suffixes spelled as they sound.
   core.String phoneticHonorificSuffix;
-  /** The middle name(s) spelled as they sound. */
+
+  /// The middle name(s) spelled as they sound.
   core.String phoneticMiddleName;
 
   Name();
@@ -2255,7 +2282,8 @@ class Name {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (displayName != null) {
       _json["displayName"] = displayName;
     }
@@ -2302,24 +2330,24 @@ class Name {
   }
 }
 
-/** A person's nickname. */
+/// A person's nickname.
 class Nickname {
-  /** Metadata about the nickname. */
+  /// Metadata about the nickname.
   FieldMetadata metadata;
-  /**
-   * The type of the nickname.
-   * Possible string values are:
-   * - "DEFAULT" : Generic nickname.
-   * - "MAIDEN_NAME" : Maiden name or birth family name. Used when the person's
-   * family name has
-   * changed as a result of marriage.
-   * - "INITIALS" : Initials.
-   * - "GPLUS" : Google+ profile nickname.
-   * - "OTHER_NAME" : A professional affiliation or other name; for example,
-   * `Dr. Smith.`
-   */
+
+  /// The type of the nickname.
+  /// Possible string values are:
+  /// - "DEFAULT" : Generic nickname.
+  /// - "MAIDEN_NAME" : Maiden name or birth family name. Used when the
+  /// person's family name has
+  /// changed as a result of marriage.
+  /// - "INITIALS" : Initials.
+  /// - "GPLUS" : Google+ profile nickname.
+  /// - "OTHER_NAME" : A professional affiliation or other name; for example,
+  /// `Dr. Smith.`
   core.String type;
-  /** The nickname. */
+
+  /// The nickname.
   core.String value;
 
   Nickname();
@@ -2337,7 +2365,8 @@ class Nickname {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -2351,11 +2380,12 @@ class Nickname {
   }
 }
 
-/** A person's occupation. */
+/// A person's occupation.
 class Occupation {
-  /** Metadata about the occupation. */
+  /// Metadata about the occupation.
   FieldMetadata metadata;
-  /** The occupation; for example, `carpenter`. */
+
+  /// The occupation; for example, `carpenter`.
   core.String value;
 
   Occupation();
@@ -2370,7 +2400,8 @@ class Occupation {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -2381,56 +2412,57 @@ class Occupation {
   }
 }
 
-/**
- * A person's past or current organization. Overlapping date ranges are
- * permitted.
- */
+/// A person's past or current organization. Overlapping date ranges are
+/// permitted.
 class Organization {
-  /**
-   * True if the organization is the person's current organization;
-   * false if the organization is a past organization.
-   */
+  /// True if the organization is the person's current organization;
+  /// false if the organization is a past organization.
   core.bool current;
-  /** The person's department at the organization. */
+
+  /// The person's department at the organization.
   core.String department;
-  /**
-   * The domain name associated with the organization; for example,
-   * `google.com`.
-   */
+
+  /// The domain name associated with the organization; for example,
+  /// `google.com`.
   core.String domain;
-  /** The end date when the person left the organization. */
+
+  /// The end date when the person left the organization.
   Date endDate;
-  /**
-   * The read-only type of the organization translated and formatted in the
-   * viewer's account locale or the `Accept-Language` HTTP header locale.
-   */
+
+  /// The read-only type of the organization translated and formatted in the
+  /// viewer's account locale or the `Accept-Language` HTTP header locale.
   core.String formattedType;
-  /** The person's job description at the organization. */
+
+  /// The person's job description at the organization.
   core.String jobDescription;
-  /** The location of the organization office the person works at. */
+
+  /// The location of the organization office the person works at.
   core.String location;
-  /** Metadata about the organization. */
+
+  /// Metadata about the organization.
   FieldMetadata metadata;
-  /** The name of the organization. */
+
+  /// The name of the organization.
   core.String name;
-  /** The phonetic name of the organization. */
+
+  /// The phonetic name of the organization.
   core.String phoneticName;
-  /** The start date when the person joined the organization. */
+
+  /// The start date when the person joined the organization.
   Date startDate;
-  /**
-   * The symbol associated with the organization; for example, a stock ticker
-   * symbol, abbreviation, or acronym.
-   */
+
+  /// The symbol associated with the organization; for example, a stock ticker
+  /// symbol, abbreviation, or acronym.
   core.String symbol;
-  /** The person's job title at the organization. */
+
+  /// The person's job title at the organization.
   core.String title;
-  /**
-   * The type of the organization. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `work`
-   * * `school`
-   */
+
+  /// The type of the organization. The type can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `work`
+  /// * `school`
   core.String type;
 
   Organization();
@@ -2481,7 +2513,8 @@ class Organization {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (current != null) {
       _json["current"] = current;
     }
@@ -2528,139 +2561,188 @@ class Organization {
   }
 }
 
-/**
- * Information about a person merged from various data sources such as the
- * 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.
- */
+/// Information about a person merged from various data sources such as the
+/// 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. */
+  /// The person's street addresses.
   core.List<Address> addresses;
-  /**
-   * **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.
-   */
+
+  /// **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 read-only age ranges. */
+
+  /// The person's read-only age ranges.
   core.List<AgeRangeType> ageRanges;
-  /** The person's biographies. */
+
+  /// The person's biographies.
   core.List<Biography> biographies;
-  /** The person's birthdays. */
+
+  /// The person's birthdays.
   core.List<Birthday> birthdays;
-  /** The person's bragging rights. */
+
+  /// The person's bragging rights.
   core.List<BraggingRights> braggingRights;
-  /** The person's read-only cover photos. */
+
+  /// The person's read-only cover photos.
   core.List<CoverPhoto> coverPhotos;
-  /** The person's email addresses. */
+
+  /// 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.
-   */
+
+  /// 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. */
+
+  /// The person's events.
   core.List<Event> events;
-  /** The person's genders. */
+
+  /// The person's genders.
   core.List<Gender> genders;
-  /** The person's instant messaging clients. */
+
+  /// The person's instant messaging clients.
   core.List<ImClient> imClients;
-  /** The person's interests. */
+
+  /// The person's interests.
   core.List<Interest> interests;
-  /** The person's locale preferences. */
+
+  /// The person's locale preferences.
   core.List<Locale> locales;
-  /** The person's read-only group memberships. */
+
+  /// The person's read-only group memberships.
   core.List<Membership> memberships;
-  /** Read-only metadata about the person. */
+
+  /// Read-only metadata about the person.
   PersonMetadata metadata;
-  /** The person's names. */
+
+  /// The person's names.
   core.List<Name> names;
-  /** The person's nicknames. */
+
+  /// The person's nicknames.
   core.List<Nickname> nicknames;
-  /** The person's occupations. */
+
+  /// The person's occupations.
   core.List<Occupation> occupations;
-  /** The person's past or current organizations. */
+
+  /// The person's past or current organizations.
   core.List<Organization> organizations;
-  /** The person's phone numbers. */
+
+  /// The person's phone numbers.
   core.List<PhoneNumber> phoneNumbers;
-  /** The person's read-only photos. */
+
+  /// The person's read-only photos.
   core.List<Photo> photos;
-  /** The person's relations. */
+
+  /// The person's relations.
   core.List<Relation> relations;
-  /** The person's read-only relationship interests. */
+
+  /// The person's read-only relationship interests.
   core.List<RelationshipInterest> relationshipInterests;
-  /** The person's read-only relationship statuses. */
+
+  /// The person's read-only relationship statuses.
   core.List<RelationshipStatus> relationshipStatuses;
-  /** The person's residences. */
+
+  /// 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/`<var>person_id</var>.
-   */
+
+  /// 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/`<var>person_id</var>.
   core.String resourceName;
-  /** The person's skills. */
+
+  /// The person's skills.
   core.List<Skill> skills;
-  /** The person's read-only taglines. */
+
+  /// The person's read-only taglines.
   core.List<Tagline> taglines;
-  /** The person's associated URLs. */
+
+  /// The person's associated URLs.
   core.List<Url> urls;
 
+  /// The person's user defined data.
+  core.List<UserDefined> userDefined;
+
   Person();
 
   Person.fromJson(core.Map _json) {
     if (_json.containsKey("addresses")) {
-      addresses = _json["addresses"].map((value) => new Address.fromJson(value)).toList();
+      addresses = _json["addresses"]
+          .map((value) => new Address.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("ageRange")) {
       ageRange = _json["ageRange"];
     }
     if (_json.containsKey("ageRanges")) {
-      ageRanges = _json["ageRanges"].map((value) => new AgeRangeType.fromJson(value)).toList();
+      ageRanges = _json["ageRanges"]
+          .map((value) => new AgeRangeType.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("biographies")) {
-      biographies = _json["biographies"].map((value) => new Biography.fromJson(value)).toList();
+      biographies = _json["biographies"]
+          .map((value) => new Biography.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("birthdays")) {
-      birthdays = _json["birthdays"].map((value) => new Birthday.fromJson(value)).toList();
+      birthdays = _json["birthdays"]
+          .map((value) => new Birthday.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("braggingRights")) {
-      braggingRights = _json["braggingRights"].map((value) => new BraggingRights.fromJson(value)).toList();
+      braggingRights = _json["braggingRights"]
+          .map((value) => new BraggingRights.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("coverPhotos")) {
-      coverPhotos = _json["coverPhotos"].map((value) => new CoverPhoto.fromJson(value)).toList();
+      coverPhotos = _json["coverPhotos"]
+          .map((value) => new CoverPhoto.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("emailAddresses")) {
-      emailAddresses = _json["emailAddresses"].map((value) => new EmailAddress.fromJson(value)).toList();
+      emailAddresses = _json["emailAddresses"]
+          .map((value) => new EmailAddress.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("etag")) {
       etag = _json["etag"];
     }
     if (_json.containsKey("events")) {
-      events = _json["events"].map((value) => new Event.fromJson(value)).toList();
+      events =
+          _json["events"].map((value) => new Event.fromJson(value)).toList();
     }
     if (_json.containsKey("genders")) {
-      genders = _json["genders"].map((value) => new Gender.fromJson(value)).toList();
+      genders =
+          _json["genders"].map((value) => new Gender.fromJson(value)).toList();
     }
     if (_json.containsKey("imClients")) {
-      imClients = _json["imClients"].map((value) => new ImClient.fromJson(value)).toList();
+      imClients = _json["imClients"]
+          .map((value) => new ImClient.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("interests")) {
-      interests = _json["interests"].map((value) => new Interest.fromJson(value)).toList();
+      interests = _json["interests"]
+          .map((value) => new Interest.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("locales")) {
-      locales = _json["locales"].map((value) => new Locale.fromJson(value)).toList();
+      locales =
+          _json["locales"].map((value) => new Locale.fromJson(value)).toList();
     }
     if (_json.containsKey("memberships")) {
-      memberships = _json["memberships"].map((value) => new Membership.fromJson(value)).toList();
+      memberships = _json["memberships"]
+          .map((value) => new Membership.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("metadata")) {
       metadata = new PersonMetadata.fromJson(_json["metadata"]);
@@ -2669,48 +2751,74 @@ class Person {
       names = _json["names"].map((value) => new Name.fromJson(value)).toList();
     }
     if (_json.containsKey("nicknames")) {
-      nicknames = _json["nicknames"].map((value) => new Nickname.fromJson(value)).toList();
+      nicknames = _json["nicknames"]
+          .map((value) => new Nickname.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("occupations")) {
-      occupations = _json["occupations"].map((value) => new Occupation.fromJson(value)).toList();
+      occupations = _json["occupations"]
+          .map((value) => new Occupation.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("organizations")) {
-      organizations = _json["organizations"].map((value) => new Organization.fromJson(value)).toList();
+      organizations = _json["organizations"]
+          .map((value) => new Organization.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("phoneNumbers")) {
-      phoneNumbers = _json["phoneNumbers"].map((value) => new PhoneNumber.fromJson(value)).toList();
+      phoneNumbers = _json["phoneNumbers"]
+          .map((value) => new PhoneNumber.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("photos")) {
-      photos = _json["photos"].map((value) => new Photo.fromJson(value)).toList();
+      photos =
+          _json["photos"].map((value) => new Photo.fromJson(value)).toList();
     }
     if (_json.containsKey("relations")) {
-      relations = _json["relations"].map((value) => new Relation.fromJson(value)).toList();
+      relations = _json["relations"]
+          .map((value) => new Relation.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("relationshipInterests")) {
-      relationshipInterests = _json["relationshipInterests"].map((value) => new RelationshipInterest.fromJson(value)).toList();
+      relationshipInterests = _json["relationshipInterests"]
+          .map((value) => new RelationshipInterest.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("relationshipStatuses")) {
-      relationshipStatuses = _json["relationshipStatuses"].map((value) => new RelationshipStatus.fromJson(value)).toList();
+      relationshipStatuses = _json["relationshipStatuses"]
+          .map((value) => new RelationshipStatus.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("residences")) {
-      residences = _json["residences"].map((value) => new Residence.fromJson(value)).toList();
+      residences = _json["residences"]
+          .map((value) => new Residence.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("resourceName")) {
       resourceName = _json["resourceName"];
     }
     if (_json.containsKey("skills")) {
-      skills = _json["skills"].map((value) => new Skill.fromJson(value)).toList();
+      skills =
+          _json["skills"].map((value) => new Skill.fromJson(value)).toList();
     }
     if (_json.containsKey("taglines")) {
-      taglines = _json["taglines"].map((value) => new Tagline.fromJson(value)).toList();
+      taglines = _json["taglines"]
+          .map((value) => new Tagline.fromJson(value))
+          .toList();
     }
     if (_json.containsKey("urls")) {
       urls = _json["urls"].map((value) => new Url.fromJson(value)).toList();
     }
+    if (_json.containsKey("userDefined")) {
+      userDefined = _json["userDefined"]
+          .map((value) => new UserDefined.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>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (addresses != null) {
       _json["addresses"] = addresses.map((value) => (value).toJson()).toList();
     }
@@ -2721,19 +2829,23 @@ class Person {
       _json["ageRanges"] = ageRanges.map((value) => (value).toJson()).toList();
     }
     if (biographies != null) {
-      _json["biographies"] = biographies.map((value) => (value).toJson()).toList();
+      _json["biographies"] =
+          biographies.map((value) => (value).toJson()).toList();
     }
     if (birthdays != null) {
       _json["birthdays"] = birthdays.map((value) => (value).toJson()).toList();
     }
     if (braggingRights != null) {
-      _json["braggingRights"] = braggingRights.map((value) => (value).toJson()).toList();
+      _json["braggingRights"] =
+          braggingRights.map((value) => (value).toJson()).toList();
     }
     if (coverPhotos != null) {
-      _json["coverPhotos"] = coverPhotos.map((value) => (value).toJson()).toList();
+      _json["coverPhotos"] =
+          coverPhotos.map((value) => (value).toJson()).toList();
     }
     if (emailAddresses != null) {
-      _json["emailAddresses"] = emailAddresses.map((value) => (value).toJson()).toList();
+      _json["emailAddresses"] =
+          emailAddresses.map((value) => (value).toJson()).toList();
     }
     if (etag != null) {
       _json["etag"] = etag;
@@ -2754,7 +2866,8 @@ class Person {
       _json["locales"] = locales.map((value) => (value).toJson()).toList();
     }
     if (memberships != null) {
-      _json["memberships"] = memberships.map((value) => (value).toJson()).toList();
+      _json["memberships"] =
+          memberships.map((value) => (value).toJson()).toList();
     }
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
@@ -2766,13 +2879,16 @@ class Person {
       _json["nicknames"] = nicknames.map((value) => (value).toJson()).toList();
     }
     if (occupations != null) {
-      _json["occupations"] = occupations.map((value) => (value).toJson()).toList();
+      _json["occupations"] =
+          occupations.map((value) => (value).toJson()).toList();
     }
     if (organizations != null) {
-      _json["organizations"] = organizations.map((value) => (value).toJson()).toList();
+      _json["organizations"] =
+          organizations.map((value) => (value).toJson()).toList();
     }
     if (phoneNumbers != null) {
-      _json["phoneNumbers"] = phoneNumbers.map((value) => (value).toJson()).toList();
+      _json["phoneNumbers"] =
+          phoneNumbers.map((value) => (value).toJson()).toList();
     }
     if (photos != null) {
       _json["photos"] = photos.map((value) => (value).toJson()).toList();
@@ -2781,13 +2897,16 @@ class Person {
       _json["relations"] = relations.map((value) => (value).toJson()).toList();
     }
     if (relationshipInterests != null) {
-      _json["relationshipInterests"] = relationshipInterests.map((value) => (value).toJson()).toList();
+      _json["relationshipInterests"] =
+          relationshipInterests.map((value) => (value).toJson()).toList();
     }
     if (relationshipStatuses != null) {
-      _json["relationshipStatuses"] = relationshipStatuses.map((value) => (value).toJson()).toList();
+      _json["relationshipStatuses"] =
+          relationshipStatuses.map((value) => (value).toJson()).toList();
     }
     if (residences != null) {
-      _json["residences"] = residences.map((value) => (value).toJson()).toList();
+      _json["residences"] =
+          residences.map((value) => (value).toJson()).toList();
     }
     if (resourceName != null) {
       _json["resourceName"] = resourceName;
@@ -2801,42 +2920,46 @@ class Person {
     if (urls != null) {
       _json["urls"] = urls.map((value) => (value).toJson()).toList();
     }
+    if (userDefined != null) {
+      _json["userDefined"] =
+          userDefined.map((value) => (value).toJson()).toList();
+    }
     return _json;
   }
 }
 
-/** The read-only metadata about a person. */
+/// The read-only metadata about a person.
 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.
-   */
+  /// 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. */
+
+  /// Resource names of people linked to this resource.
   core.List<core.String> linkedPeopleResourceNames;
-  /**
-   * **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/)
-   */
+
+  /// **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
-   * that include a sync token.
-   *
-   * The resource name may change when adding or removing fields that link a
-   * contact and profile such as a verified email, verified phone number, or
-   * profile URL.
-   */
+
+  /// Any former resource names this person has had. Populated only for
+  /// [`connections.list`](/people/api/rest/v1/people.connections/list)
+  /// requests
+  /// that include a sync token.
+  ///
+  /// The resource name may change when adding or removing fields that link a
+  /// contact and profile such as a verified email, verified phone number, or
+  /// profile URL.
   core.List<core.String> previousResourceNames;
-  /** The sources of data for the person. */
+
+  /// The sources of data for the person.
   core.List<Source> sources;
 
   PersonMetadata();
@@ -2855,12 +2978,14 @@ class PersonMetadata {
       previousResourceNames = _json["previousResourceNames"];
     }
     if (_json.containsKey("sources")) {
-      sources = _json["sources"].map((value) => new Source.fromJson(value)).toList();
+      sources =
+          _json["sources"].map((value) => new Source.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>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (deleted != null) {
       _json["deleted"] = deleted;
     }
@@ -2880,27 +3005,26 @@ class PersonMetadata {
   }
 }
 
-/** The response for a single person */
+/// 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. */
+
+  /// 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
-   * profile URL.
-   */
+
+  /// 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
+  /// profile URL.
   core.String requestedResourceName;
-  /** The status of the response. */
+
+  /// The status of the response.
   Status status;
 
   PersonResponse();
@@ -2921,7 +3045,8 @@ class PersonResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (httpStatusCode != null) {
       _json["httpStatusCode"] = httpStatusCode;
     }
@@ -2938,40 +3063,38 @@ class PersonResponse {
   }
 }
 
-/** A person's phone number. */
+/// 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.
-   */
+  /// 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 `Accept-Language` HTTP header locale.
-   */
+
+  /// The read-only type of the phone number translated and formatted in the
+  /// viewer's account locale or the `Accept-Language` HTTP header locale.
   core.String formattedType;
-  /** Metadata about the phone number. */
+
+  /// 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`
-   * * `mobile`
-   * * `homeFax`
-   * * `workFax`
-   * * `otherFax`
-   * * `pager`
-   * * `workMobile`
-   * * `workPager`
-   * * `main`
-   * * `googleVoice`
-   * * `other`
-   */
+
+  /// 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`
+  /// * `mobile`
+  /// * `homeFax`
+  /// * `workFax`
+  /// * `otherFax`
+  /// * `pager`
+  /// * `workMobile`
+  /// * `workPager`
+  /// * `main`
+  /// * `googleVoice`
+  /// * `other`
   core.String type;
-  /** The phone number. */
+
+  /// The phone number.
   core.String value;
 
   PhoneNumber();
@@ -2995,7 +3118,8 @@ class PhoneNumber {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (canonicalForm != null) {
       _json["canonicalForm"] = canonicalForm;
     }
@@ -3015,18 +3139,16 @@ class PhoneNumber {
   }
 }
 
-/**
- * A person's read-only photo. A picture shown next to the person's name to
- * help others recognize the person.
- */
+/// A person's read-only photo. A picture shown next to the person's name to
+/// help others recognize the person.
 class Photo {
-  /** Metadata about the photo. */
+  /// Metadata about the photo.
   FieldMetadata metadata;
-  /**
-   * The URL of the photo. You can change the desired size by appending a query
-   * parameter `sz=`<var>size</var> at the end of the url. Example:
-   * `https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50`
-   */
+
+  /// The URL of the photo. You can change the desired size by appending a
+  /// query
+  /// parameter `sz=`<var>size</var> at the end of the url. Example:
+  /// `https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50`
   core.String url;
 
   Photo();
@@ -3041,7 +3163,8 @@ class Photo {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -3052,17 +3175,16 @@ class Photo {
   }
 }
 
-/** The read-only metadata about a profile. */
+/// 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/)
-   */
+  /// 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. */
+
+  /// The user types.
   core.List<core.String> userTypes;
 
   ProfileMetadata();
@@ -3077,7 +3199,8 @@ class ProfileMetadata {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (objectType != null) {
       _json["objectType"] = objectType;
     }
@@ -3088,37 +3211,36 @@ class ProfileMetadata {
   }
 }
 
-/** A person's relation to another person. */
+/// 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.
-   */
+  /// The type of the relation translated and formatted in the viewer's account
+  /// locale or the locale specified in the Accept-Language HTTP header.
   core.String formattedType;
-  /** Metadata about the relation. */
+
+  /// Metadata about the relation.
   FieldMetadata metadata;
-  /** The name of the other person this relation refers to. */
+
+  /// The name of the other person this relation refers to.
   core.String person;
-  /**
-   * The person's relation to the other person. The type can be custom or
-   * predefined.
-   * Possible values include, but are not limited to, the following values:
-   *
-   * * `spouse`
-   * * `child`
-   * * `mother`
-   * * `father`
-   * * `parent`
-   * * `brother`
-   * * `sister`
-   * * `friend`
-   * * `relative`
-   * * `domesticPartner`
-   * * `manager`
-   * * `assistant`
-   * * `referredBy`
-   * * `partner`
-   */
+
+  /// The person's relation to the other person. The type can be custom or
+  /// predefined.
+  /// Possible values include, but are not limited to, the following values:
+  ///
+  /// * `spouse`
+  /// * `child`
+  /// * `mother`
+  /// * `father`
+  /// * `parent`
+  /// * `brother`
+  /// * `sister`
+  /// * `friend`
+  /// * `relative`
+  /// * `domesticPartner`
+  /// * `manager`
+  /// * `assistant`
+  /// * `referredBy`
+  /// * `partner`
   core.String type;
 
   Relation();
@@ -3139,7 +3261,8 @@ class Relation {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (formattedType != null) {
       _json["formattedType"] = formattedType;
     }
@@ -3156,26 +3279,25 @@ class Relation {
   }
 }
 
-/** A person's read-only relationship interest . */
+/// A person's read-only relationship interest .
 class RelationshipInterest {
-  /**
-   * The value of the relationship interest translated and formatted in the
-   * viewer's account locale or the locale specified in the Accept-Language
-   * HTTP header.
-   */
+  /// The value of the relationship interest translated and formatted in the
+  /// viewer's account locale or the locale specified in the Accept-Language
+  /// HTTP header.
   core.String formattedValue;
-  /** Metadata about the relationship interest. */
+
+  /// Metadata about the relationship interest.
   FieldMetadata metadata;
-  /**
-   * The kind of relationship the person is looking for. The value can be custom
-   * or predefined. Possible values include, but are not limited to, the
-   * following values:
-   *
-   * * `friend`
-   * * `date`
-   * * `relationship`
-   * * `networking`
-   */
+
+  /// The kind of relationship the person is looking for. The value can be
+  /// custom
+  /// or predefined. Possible values include, but are not limited to, the
+  /// following values:
+  ///
+  /// * `friend`
+  /// * `date`
+  /// * `relationship`
+  /// * `networking`
   core.String value;
 
   RelationshipInterest();
@@ -3193,7 +3315,8 @@ class RelationshipInterest {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (formattedValue != null) {
       _json["formattedValue"] = formattedValue;
     }
@@ -3207,29 +3330,28 @@ class RelationshipInterest {
   }
 }
 
-/** A person's read-only relationship status. */
+/// A person's read-only relationship status.
 class RelationshipStatus {
-  /**
-   * The read-only value of the relationship status translated and formatted in
-   * the viewer's account locale or the `Accept-Language` HTTP header locale.
-   */
+  /// The read-only value of the relationship status translated and formatted
+  /// in
+  /// the viewer's account locale or the `Accept-Language` HTTP header locale.
   core.String formattedValue;
-  /** Metadata about the relationship status. */
+
+  /// Metadata about the relationship status.
   FieldMetadata metadata;
-  /**
-   * The relationship status. The value can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `single`
-   * * `inARelationship`
-   * * `engaged`
-   * * `married`
-   * * `itsComplicated`
-   * * `openRelationship`
-   * * `widowed`
-   * * `inDomesticPartnership`
-   * * `inCivilUnion`
-   */
+
+  /// The relationship status. The value can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `single`
+  /// * `inARelationship`
+  /// * `engaged`
+  /// * `married`
+  /// * `itsComplicated`
+  /// * `openRelationship`
+  /// * `widowed`
+  /// * `inDomesticPartnership`
+  /// * `inCivilUnion`
   core.String value;
 
   RelationshipStatus();
@@ -3247,7 +3369,8 @@ class RelationshipStatus {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (formattedValue != null) {
       _json["formattedValue"] = formattedValue;
     }
@@ -3261,16 +3384,16 @@ class RelationshipStatus {
   }
 }
 
-/** A person's past or current residence. */
+/// A person's past or current residence.
 class Residence {
-  /**
-   * True if the residence is the person's current residence;
-   * false if the residence is a past residence.
-   */
+  /// True if the residence is the person's current residence;
+  /// false if the residence is a past residence.
   core.bool current;
-  /** Metadata about the residence. */
+
+  /// Metadata about the residence.
   FieldMetadata metadata;
-  /** The address of the residence. */
+
+  /// The address of the residence.
   core.String value;
 
   Residence();
@@ -3288,7 +3411,8 @@ class Residence {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (current != null) {
       _json["current"] = current;
     }
@@ -3302,11 +3426,12 @@ class Residence {
   }
 }
 
-/** A skill that the person has. */
+/// A skill that the person has.
 class Skill {
-  /** Metadata about the skill. */
+  /// Metadata about the skill.
   FieldMetadata metadata;
-  /** The skill; for example, `underwater basket weaving`. */
+
+  /// The skill; for example, `underwater basket weaving`.
   core.String value;
 
   Skill();
@@ -3321,7 +3446,8 @@ class Skill {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -3332,45 +3458,41 @@ class Skill {
   }
 }
 
-/** The source of a field. */
+/// The source of a field.
 class Source {
-  /**
-   * **Only populated in `person.metadata.sources`.**
-   *
-   * The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
-   * source. Used for web cache validation.
-   */
+  /// **Only populated in `person.metadata.sources`.**
+  ///
+  /// The [HTTP entity tag](https://en.wikipedia.org/wiki/HTTP_ETag) of the
+  /// source. Used for web cache validation.
   core.String etag;
-  /** The unique identifier within the source type generated by the server. */
+
+  /// The unique identifier within the source type generated by the server.
   core.String id;
-  /**
-   * **Only populated in `person.metadata.sources`.**
-   *
-   * Metadata about a source of type PROFILE.
-   */
+
+  /// **Only populated in `person.metadata.sources`.**
+  ///
+  /// 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/<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/<var>id</var> where <var>id</var>
-   * is the source id.
-   */
+
+  /// 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/<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/<var>id</var> where <var>id</var>
+  /// is the source id.
   core.String type;
-  /**
-   * **Only populated in `person.metadata.sources`.**
-   *
-   * Last update timestamp of this source.
-   */
+
+  /// **Only populated in `person.metadata.sources`.**
+  ///
+  /// Last update timestamp of this source.
   core.String updateTime;
 
   Source();
@@ -3394,7 +3516,8 @@ class Source {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (etag != null) {
       _json["etag"] = etag;
     }
@@ -3414,78 +3537,81 @@ class Source {
   }
 }
 
-/**
- * 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:
- *
- * - Simple to use and understand for most users
- * - Flexible enough to meet unexpected needs
- *
- * # Overview
- *
- * The `Status` message contains three pieces of data: error code, error
- * message,
- * and error details. The error code should be an enum value of
- * google.rpc.Code, but it may accept additional error codes if needed.  The
- * error message should be a developer-facing English message that helps
- * developers *understand* and *resolve* the error. If a localized user-facing
- * error message is needed, put the localized message in the error details or
- * localize it in the client. The optional error details may contain arbitrary
- * information about the error. There is a predefined set of error detail types
- * in the package `google.rpc` that can be used for common error conditions.
- *
- * # Language mapping
- *
- * The `Status` message is the logical representation of the error model, but it
- * is not necessarily the actual wire format. When the `Status` message is
- * exposed in different client libraries and different wire protocols, it can be
- * mapped differently. For example, it will likely be mapped to some exceptions
- * in Java, but more likely mapped to some error codes in C.
- *
- * # Other uses
- *
- * The error model and the `Status` message can be used in a variety of
- * environments, either with or without APIs, to provide a
- * consistent developer experience across different environments.
- *
- * Example uses of this error model include:
- *
- * - Partial errors. If a service needs to return partial errors to the client,
- *     it may embed the `Status` in the normal response to indicate the partial
- *     errors.
- *
- * - Workflow errors. A typical workflow has multiple steps. Each step may
- *     have a `Status` message for error reporting.
- *
- * - Batch operations. If a client uses batch request and batch response, the
- *     `Status` message should be used directly inside batch response, one for
- *     each error sub-response.
- *
- * - Asynchronous operations. If an API call embeds asynchronous operation
- *     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.
- */
+/// 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:
+///
+/// - Simple to use and understand for most users
+/// - Flexible enough to meet unexpected needs
+///
+/// # Overview
+///
+/// The `Status` message contains three pieces of data: error code, error
+/// message,
+/// and error details. The error code should be an enum value of
+/// google.rpc.Code, but it may accept additional error codes if needed.  The
+/// error message should be a developer-facing English message that helps
+/// developers *understand* and *resolve* the error. If a localized user-facing
+/// error message is needed, put the localized message in the error details or
+/// localize it in the client. The optional error details may contain arbitrary
+/// information about the error. There is a predefined set of error detail
+/// types
+/// in the package `google.rpc` that can be used for common error conditions.
+///
+/// # Language mapping
+///
+/// The `Status` message is the logical representation of the error model, but
+/// it
+/// is not necessarily the actual wire format. When the `Status` message is
+/// exposed in different client libraries and different wire protocols, it can
+/// be
+/// mapped differently. For example, it will likely be mapped to some
+/// exceptions
+/// in Java, but more likely mapped to some error codes in C.
+///
+/// # Other uses
+///
+/// The error model and the `Status` message can be used in a variety of
+/// environments, either with or without APIs, to provide a
+/// consistent developer experience across different environments.
+///
+/// Example uses of this error model include:
+///
+/// - Partial errors. If a service needs to return partial errors to the
+/// client,
+/// it may embed the `Status` in the normal response to indicate the partial
+///     errors.
+///
+/// - Workflow errors. A typical workflow has multiple steps. Each step may
+///     have a `Status` message for error reporting.
+///
+/// - Batch operations. If a client uses batch request and batch response, the
+/// `Status` message should be used directly inside batch response, one for
+///     each error sub-response.
+///
+/// - Asynchronous operations. If an API call embeds asynchronous operation
+///     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. */
+  /// 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 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.
-   */
+
+  /// 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.
-   */
+
+  /// 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.
   core.String message;
 
   Status();
@@ -3503,7 +3629,8 @@ class Status {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (code != null) {
       _json["code"] = code;
     }
@@ -3517,11 +3644,12 @@ class Status {
   }
 }
 
-/** A read-only brief one-line description of the person. */
+/// A read-only brief one-line description of the person.
 class Tagline {
-  /** Metadata about the tagline. */
+  /// Metadata about the tagline.
   FieldMetadata metadata;
-  /** The tagline. */
+
+  /// The tagline.
   core.String value;
 
   Tagline();
@@ -3536,7 +3664,8 @@ class Tagline {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
@@ -3547,11 +3676,10 @@ class Tagline {
   }
 }
 
-/**
- * A request to update an existing contact group. Only the name can be updated.
- */
+/// A request to update an existing contact group. Only the name can be
+/// updated.
 class UpdateContactGroupRequest {
-  /** The contact group to update. */
+  /// The contact group to update.
   ContactGroup contactGroup;
 
   UpdateContactGroupRequest();
@@ -3563,7 +3691,8 @@ class UpdateContactGroupRequest {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (contactGroup != null) {
       _json["contactGroup"] = (contactGroup).toJson();
     }
@@ -3571,31 +3700,30 @@ class UpdateContactGroupRequest {
   }
 }
 
-/** A person's associated URLs. */
+/// 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.
-   */
+  /// 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. */
+
+  /// Metadata about the URL.
   FieldMetadata metadata;
-  /**
-   * The type of the URL. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following:
-   *
-   * * `home`
-   * * `work`
-   * * `blog`
-   * * `profile`
-   * * `homePage`
-   * * `ftp`
-   * * `reservations`
-   * * `appInstallPage`: website for a Google+ application.
-   * * `other`
-   */
+
+  /// The type of the URL. The type can be custom or predefined.
+  /// Possible values include, but are not limited to, the following:
+  ///
+  /// * `home`
+  /// * `work`
+  /// * `blog`
+  /// * `profile`
+  /// * `homePage`
+  /// * `ftp`
+  /// * `reservations`
+  /// * `appInstallPage`: website for a Google+ application.
+  /// * `other`
   core.String type;
-  /** The URL. */
+
+  /// The URL.
   core.String value;
 
   Url();
@@ -3616,7 +3744,8 @@ class Url {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (formattedType != null) {
       _json["formattedType"] = formattedType;
     }
@@ -3632,3 +3761,44 @@ class Url {
     return _json;
   }
 }
+
+/// Arbitrary user data that is populated by the end users.
+class UserDefined {
+  /// The end user specified key of the user defined data.
+  core.String key;
+
+  /// Metadata about the user defined data.
+  FieldMetadata metadata;
+
+  /// The end user specified value of the user defined data.
+  core.String value;
+
+  UserDefined();
+
+  UserDefined.fromJson(core.Map _json) {
+    if (_json.containsKey("key")) {
+      key = _json["key"];
+    }
+    if (_json.containsKey("metadata")) {
+      metadata = new FieldMetadata.fromJson(_json["metadata"]);
+    }
+    if (_json.containsKey("value")) {
+      value = _json["value"];
+    }
+  }
+
+  core.Map<core.String, core.Object> toJson() {
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
+    if (key != null) {
+      _json["key"] = key;
+    }
+    if (metadata != null) {
+      _json["metadata"] = (metadata).toJson();
+    }
+    if (value != null) {
+      _json["value"] = value;
+    }
+    return _json;
+  }
+}