Api-roll 45: 2017-02-13

generated/googleapis/lib/people/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.people.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
 
 export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
     ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client people/v1';
 
-/**
- * The Google People API service gives access to information about profiles and
- * contacts.
- */
+/** Provides access to information about profiles and contacts. */
 class PeopleApi {
   /** 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";
 
-  /** Know your basic profile info and list of people in your circles. */
+  /** 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 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";
@@ skipping 13 matching lines @@
   PeopleResourceApi get people => new PeopleResourceApi(_requester);
 
   PeopleApi(http.Client client, {core.String rootUrl: "https://people.googleapis.com/", core.String servicePath: ""}) :
       _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
 }
 
 
 class PeopleResourceApi {
   final commons.ApiRequester _requester;
 
-  PeopleConnectionsResourceApi get connections => new PeopleConnectionsResourceApi(_requester);
+  PeopleMeResourceApi get me => new PeopleMeResourceApi(_requester);
 
   PeopleResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Provides information about a person resource for a resource name. Use
    * `people/me` to indicate the authenticated user.
    *
    * Request parameters:
    *
    * [resourceName] - The resource name of the person to provide information
-   * about. - To get information about the authenticated user, specify
-   * `people/me`. - To get information about any user, specify the resource name
-   * that identifies the user, such as the resource names returned by
+   * about.
+   *
+   * - To get information about the authenticated user, specify `people/me`.
+   * - To get information about any user, specify the resource name that
+   *   identifies the user, such as the resource names returned by
    * [`people.connections.list`](/people/api/rest/v1/people.connections/list).
-   * Value must have pattern "^people/[^/]*$".
+   * Value must have pattern "^people/[^/]+$".
    *
    * [requestMask_includeField] - Comma-separated list of fields to be included
-   * in the response. Omitting this field will include all fields. Each path
-   * should start with `person.`: for example, `person.names` or
+   * in the response. Omitting
+   * this field will include all fields except for connections.list requests,
+   * which have a default mask that includes common fields like metadata, name,
+   * photo, and profile url.
+   * 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.
    */
@@ skipping 24 matching lines @@
     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.
    *
    * Request parameters:
    *
+   * [requestMask_includeField] - Comma-separated list of fields to be included
+   * in the response. Omitting
+   * this field will include all fields except for connections.list requests,
+   * which have a default mask that includes common fields like metadata, name,
+   * photo, and profile url.
+   * Each path should start with `person.`: for example, `person.names` or
+   * `person.photos`.
+   *
    * [resourceNames] - The resource name, such as one returned by
    * [`people.connections.list`](/people/api/rest/v1/people.connections/list),
    * of one of the people to provide information about. You can include this
    * parameter up to 50 times in one request.
    *
-   * [requestMask_includeField] - Comma-separated list of fields to be included
-   * in the response. Omitting this field will include all fields. Each path
-   * should start with `person.`: for example, `person.names` or
-   * `person.photos`.
-   *
    * 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.List<core.String> resourceNames, core.String requestMask_includeField}) {
+  async.Future<GetPeopleResponse> getBatchGet({core.String requestMask_includeField, core.List<core.String> resourceNames}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
+    if (requestMask_includeField != null) {
+      _queryParams["requestMask.includeField"] = [requestMask_includeField];
+    }
     if (resourceNames != null) {
       _queryParams["resourceNames"] = resourceNames;
     }
-    if (requestMask_includeField != null) {
-      _queryParams["requestMask.includeField"] = [requestMask_includeField];
-    }
 
     _url = 'v1/people:batchGet';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new GetPeopleResponse.fromJson(data));
   }
 
 }
 
 
-class PeopleConnectionsResourceApi {
+class PeopleMeResourceApi {
   final commons.ApiRequester _requester;
 
-  PeopleConnectionsResourceApi(commons.ApiRequester client) : 
+  PeopleMeConnectionsResourceApi get connections => new PeopleMeConnectionsResourceApi(_requester);
+
+  PeopleMeResourceApi(commons.ApiRequester client) : 
+      _requester = client;
+}
+
+
+class PeopleMeConnectionsResourceApi {
+  final commons.ApiRequester _requester;
+
+  PeopleMeConnectionsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Provides a list of the authenticated user's contacts merged with any linked
-   * profiles.
+   * Provides a list of the authenticated user's contacts merged with any
+   * linked profiles.
    *
    * Request parameters:
    *
-   * [resourceName] - The resource name to return connections for. Only
-   * `people/me` is valid.
-   * Value must have pattern "^people/[^/]*$".
-   *
-   * [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 500, inclusive. Defaults to 100.
-   *
    * [sortOrder] - The order in which the connections should be sorted. Defaults
-   * to `LAST_MODIFIED_ASCENDING`.
+   * 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.
    *
    * [syncToken] - A sync token, returned by a previous call to
-   * `people.connections.list`. Only resources changed since the sync token was
-   * created are returned.
+   * `people.connections.list`.
+   * Only resources changed since the sync token was created will be returned.
+   *
+   * [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 500, inclusive. Defaults to 100.
    *
    * [requestMask_includeField] - Comma-separated list of fields to be included
-   * in the response. Omitting this field will include all fields. Each path
-   * should start with `person.`: for example, `person.names` or
+   * in the response. Omitting
+   * this field will include all fields except for connections.list requests,
+   * which have a default mask that includes common fields like metadata, name,
+   * photo, and profile url.
+   * Each path should start with `person.`: for example, `person.names` or
    * `person.photos`.
    *
    * Completes with a [ListConnectionsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListConnectionsResponse> list(core.String resourceName, {core.String pageToken, core.int pageSize, core.String sortOrder, core.String syncToken, core.String requestMask_includeField}) {
+  async.Future<ListConnectionsResponse> list({core.String sortOrder, core.String syncToken, core.String pageToken, core.int pageSize, core.String requestMask_includeField}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-    if (resourceName == null) {
-      throw new core.ArgumentError("Parameter resourceName is required.");
+    if (sortOrder != null) {
+      _queryParams["sortOrder"] = [sortOrder];
+    }
+    if (syncToken != null) {
+      _queryParams["syncToken"] = [syncToken];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (sortOrder != null) {
-      _queryParams["sortOrder"] = [sortOrder];
-    }
-    if (syncToken != null) {
-      _queryParams["syncToken"] = [syncToken];
-    }
     if (requestMask_includeField != null) {
       _queryParams["requestMask.includeField"] = [requestMask_includeField];
     }
 
-    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/connections';
+    _url = 'v1/people/me/connections';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListConnectionsResponse.fromJson(data));
   }
@@ skipping 19 matching lines @@
   /**
    * 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.
    */
   core.String formattedType;
   /**
-   * The read-only value of the address formatted in the viewer's account locale
-   * or the `Accept-Language` HTTP header locale.
+   * 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. */
   FieldMetadata metadata;
   /** The P.O. box of the address. */
   core.String poBox;
   /** The postal code of the address. */
   core.String postalCode;
   /** The region of the address; for example, the state or province. */
   core.String region;
   /** 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();
 
   Address.fromJson(core.Map _json) {
     if (_json.containsKey("city")) {
       city = _json["city"];
     }
     if (_json.containsKey("country")) {
@@ skipping 68 matching lines @@
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /** A person's short biography. */
 class Biography {
+  /**
+   * The content type of the biography.
+   * Possible string values are:
+   * - "CONTENT_TYPE_UNSPECIFIED" : Unspecified.
+   * - "TEXT_PLAIN" : Plain text.
+   * - "TEXT_HTML" : HTML text.
+   */
+  core.String contentType;
   /** Metadata about the biography. */
   FieldMetadata metadata;
   /** The short biography. */
   core.String value;
 
   Biography();
 
   Biography.fromJson(core.Map _json) {
+    if (_json.containsKey("contentType")) {
+      contentType = _json["contentType"];
+    }
     if (_json.containsKey("metadata")) {
       metadata = new FieldMetadata.fromJson(_json["metadata"]);
     }
     if (_json.containsKey("value")) {
       value = _json["value"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (contentType != null) {
+      _json["contentType"] = contentType;
+    }
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /**
  * 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.
+ * specified. The `date` and `text` fields typically represent the same
+ * date, but are not guaranteed to.
  */
 class Birthday {
   /** The date of the birthday. */
   Date date;
   /** Metadata about the birthday. */
   FieldMetadata metadata;
   /** A free-form string representing the user's birthday. */
   core.String text;
 
   Birthday();
@@ skipping 51 matching lines @@
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /** A Google contact group membership. */
 class ContactGroupMembership {
   /**
-   * The contact group ID for the contact group membership. The contact group ID
-   * can be custom or predefined. Possible values include, but are not limited
-   * to, the following: * `myContacts` * `starred` * A numerical ID for
-   * user-created groups.
+   * 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();
 
   ContactGroupMembership.fromJson(core.Map _json) {
     if (_json.containsKey("contactGroupId")) {
       contactGroupId = _json["contactGroupId"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (contactGroupId != null) {
       _json["contactGroupId"] = contactGroupId;
     }
     return _json;
   }
 }
 
 /**
- * A person's 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. */
   FieldMetadata metadata;
   /** The URL of the cover photo. */
   core.String url;
 
   CoverPhoto();
 
   CoverPhoto.fromJson(core.Map _json) {
@@ skipping 17 matching lines @@
       _json["metadata"] = (metadata).toJson();
     }
     if (url != null) {
       _json["url"] = url;
     }
     return _json;
   }
 }
 
 /**
- * Represents a whole calendar date, for example a date of birth. The time of
- * day and time zone are either specified elsewhere or are not significant. The
- * date is relative to the [Proleptic Gregorian
- * Calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). The
- * day may be 0 to represent a year and month where the day is not significant.
- * The year may be 0 to represent a month and day independent of year; for
- * example, anniversary date.
+ * 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.
    */
   core.int day;
   /** 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();
 
   Date.fromJson(core.Map _json) {
     if (_json.containsKey("day")) {
       day = _json["day"];
     }
     if (_json.containsKey("month")) {
@@ skipping 36 matching lines @@
     var _json = new core.Map();
     if (inViewerDomain != null) {
       _json["inViewerDomain"] = inViewerDomain;
     }
     return _json;
   }
 }
 
 /** A person's email address. */
 class EmailAddress {
+  /** 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.
    */
   core.String formattedType;
   /** 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`
+   * Possible values include, but are not limited to, the following:
+   *
+   * * `home`
+   * * `work`
+   * * `other`
    */
   core.String type;
   /** The email address. */
   core.String value;
 
   EmailAddress();
 
   EmailAddress.fromJson(core.Map _json) {
+    if (_json.containsKey("displayName")) {
+      displayName = _json["displayName"];
+    }
     if (_json.containsKey("formattedType")) {
       formattedType = _json["formattedType"];
     }
     if (_json.containsKey("metadata")) {
       metadata = new FieldMetadata.fromJson(_json["metadata"]);
     }
     if (_json.containsKey("type")) {
       type = _json["type"];
     }
     if (_json.containsKey("value")) {
       value = _json["value"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (displayName != null) {
+      _json["displayName"] = displayName;
+    }
     if (formattedType != null) {
       _json["formattedType"] = formattedType;
     }
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (type != null) {
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /** An event related to the person. */
 class Event {
   /** The date of the event. */
   Date date;
   /**
-   * The read-only type of the event translated and formatted in the viewer's
-   * account locale or the `Accept-Language` HTTP header locale.
+   * 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. */
   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();
 
   Event.fromJson(core.Map _json) {
     if (_json.containsKey("date")) {
       date = new Date.fromJson(_json["date"]);
     }
     if (_json.containsKey("formattedType")) {
@@ skipping 28 matching lines @@
 /** Metadata about a field. */
 class FieldMetadata {
   /**
    * True if the field is the primary field; false if the field is a secondary
    * field.
    */
   core.bool primary;
   /** 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();
 
   FieldMetadata.fromJson(core.Map _json) {
     if (_json.containsKey("primary")) {
       primary = _json["primary"];
     }
     if (_json.containsKey("source")) {
@@ skipping 22 matching lines @@
 /** 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.
    */
   core.String formattedValue;
   /** 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();
 
   Gender.fromJson(core.Map _json) {
     if (_json.containsKey("formattedValue")) {
       formattedValue = _json["formattedValue"];
     }
     if (_json.containsKey("metadata")) {
@@ skipping 49 matching lines @@
   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.
    */
   core.String formattedType;
   /** 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`
+   * 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. */
   core.String username;
 
   ImClient();
 
   ImClient.fromJson(core.Map _json) {
     if (_json.containsKey("formattedProtocol")) {
       formattedProtocol = _json["formattedProtocol"];
@@ skipping 104 matching lines @@
     }
     return _json;
   }
 }
 
 /** A person's locale preference. */
 class Locale {
   /** Metadata about the locale. */
   FieldMetadata metadata;
   /**
-   * The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47) language
-   * tag representing the locale.
+   * The well-formed [IETF BCP 47](https://tools.ietf.org/html/bcp47)
+   * language tag representing the locale.
    */
   core.String value;
 
   Locale();
 
   Locale.fromJson(core.Map _json) {
     if (_json.containsKey("metadata")) {
       metadata = new FieldMetadata.fromJson(_json["metadata"]);
     }
     if (_json.containsKey("value")) {
       value = _json["value"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
-/** A person's membership in a group. */
+/** A person's read-only membership in a group. */
 class Membership {
   /** The contact group membership. */
   ContactGroupMembership contactGroupMembership;
   /** The domain membership. */
   DomainMembership domainMembership;
   /** Metadata about the membership. */
   FieldMetadata metadata;
 
   Membership();
 
@@ skipping 20 matching lines @@
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     return _json;
   }
 }
 
 /** A person's name. If the name is a mononym, the family name is empty. */
 class Name {
   /**
-   * The 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 <code>Accept-Language</code> HTTP header.
    */
   core.String displayName;
+  /**
+   * The read-only display name with the last name first formatted according to
+   * the locale specified by the viewer's account or the
+   * <code>Accept-Language</code> HTTP header.
+   */
+  core.String displayNameLastFirst;
   /** The family name. */
   core.String familyName;
   /** The given name. */
   core.String givenName;
   /** The honorific prefixes, such as `Mrs.` or `Dr.` */
   core.String honorificPrefix;
   /** The honorific suffixes, such as `Jr.` */
   core.String honorificSuffix;
   /** Metadata about the name. */
   FieldMetadata metadata;
   /** The middle name(s). */
   core.String middleName;
   /** The family name spelled as it sounds. */
   core.String phoneticFamilyName;
+  /** The full name spelled as it sounds. */
+  core.String phoneticFullName;
   /** The given name spelled as it sounds. */
   core.String phoneticGivenName;
   /** The honorific prefixes spelled as they sound. */
   core.String phoneticHonorificPrefix;
   /** The honorific suffixes spelled as they sound. */
   core.String phoneticHonorificSuffix;
   /** The middle name(s) spelled as they sound. */
   core.String phoneticMiddleName;
 
   Name();
 
   Name.fromJson(core.Map _json) {
     if (_json.containsKey("displayName")) {
       displayName = _json["displayName"];
     }
+    if (_json.containsKey("displayNameLastFirst")) {
+      displayNameLastFirst = _json["displayNameLastFirst"];
+    }
     if (_json.containsKey("familyName")) {
       familyName = _json["familyName"];
     }
     if (_json.containsKey("givenName")) {
       givenName = _json["givenName"];
     }
     if (_json.containsKey("honorificPrefix")) {
       honorificPrefix = _json["honorificPrefix"];
     }
     if (_json.containsKey("honorificSuffix")) {
       honorificSuffix = _json["honorificSuffix"];
     }
     if (_json.containsKey("metadata")) {
       metadata = new FieldMetadata.fromJson(_json["metadata"]);
     }
     if (_json.containsKey("middleName")) {
       middleName = _json["middleName"];
     }
     if (_json.containsKey("phoneticFamilyName")) {
       phoneticFamilyName = _json["phoneticFamilyName"];
     }
+    if (_json.containsKey("phoneticFullName")) {
+      phoneticFullName = _json["phoneticFullName"];
+    }
     if (_json.containsKey("phoneticGivenName")) {
       phoneticGivenName = _json["phoneticGivenName"];
     }
     if (_json.containsKey("phoneticHonorificPrefix")) {
       phoneticHonorificPrefix = _json["phoneticHonorificPrefix"];
     }
     if (_json.containsKey("phoneticHonorificSuffix")) {
       phoneticHonorificSuffix = _json["phoneticHonorificSuffix"];
     }
     if (_json.containsKey("phoneticMiddleName")) {
       phoneticMiddleName = _json["phoneticMiddleName"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (displayName != null) {
       _json["displayName"] = displayName;
     }
+    if (displayNameLastFirst != null) {
+      _json["displayNameLastFirst"] = displayNameLastFirst;
+    }
     if (familyName != null) {
       _json["familyName"] = familyName;
     }
     if (givenName != null) {
       _json["givenName"] = givenName;
     }
     if (honorificPrefix != null) {
       _json["honorificPrefix"] = honorificPrefix;
     }
     if (honorificSuffix != null) {
       _json["honorificSuffix"] = honorificSuffix;
     }
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (middleName != null) {
       _json["middleName"] = middleName;
     }
     if (phoneticFamilyName != null) {
       _json["phoneticFamilyName"] = phoneticFamilyName;
     }
+    if (phoneticFullName != null) {
+      _json["phoneticFullName"] = phoneticFullName;
+    }
     if (phoneticGivenName != null) {
       _json["phoneticGivenName"] = phoneticGivenName;
     }
     if (phoneticHonorificPrefix != null) {
       _json["phoneticHonorificPrefix"] = phoneticHonorificPrefix;
     }
     if (phoneticHonorificSuffix != null) {
       _json["phoneticHonorificSuffix"] = phoneticHonorificSuffix;
     }
     if (phoneticMiddleName != null) {
       _json["phoneticMiddleName"] = phoneticMiddleName;
     }
     return _json;
   }
 }
 
 /** A person's nickname. */
 class Nickname {
   /** Metadata about the nickname. */
   FieldMetadata metadata;
   /**
    * The type of the nickname.
    * Possible string values are:
-   * - "DEFAULT" : A DEFAULT.
-   * - "MAIDEN_NAME" : A MAIDEN_NAME.
-   * - "INITIALS" : A INITIALS.
-   * - "GPLUS" : A GPLUS.
-   * - "OTHER_NAME" : A OTHER_NAME.
+   * - "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. */
   core.String value;
 
   Nickname();
 
   Nickname.fromJson(core.Map _json) {
     if (_json.containsKey("metadata")) {
       metadata = new FieldMetadata.fromJson(_json["metadata"]);
@@ skipping 50 matching lines @@
     return _json;
   }
 }
 
 /**
  * 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. */
   core.String department;
   /**
    * The domain name associated with the organization; for example,
    * `google.com`.
    */
   core.String domain;
   /** The end date when the person left the organization. */
@@ skipping 17 matching lines @@
   Date startDate;
   /**
    * 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. */
   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`
+   * Possible values include, but are not limited to, the following:
+   *
+   * * `work`
+   * * `school`
    */
   core.String type;
 
   Organization();
 
   Organization.fromJson(core.Map _json) {
     if (_json.containsKey("current")) {
       current = _json["current"];
     }
     if (_json.containsKey("department")) {
@@ skipping 81 matching lines @@
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /**
  * Information about a person merged from various data sources such as the
  * authenticated user's contacts and profile data. Fields other than IDs,
- * metadata, and group memberships are user-edited. 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, and group memberships are user-edited.
+ *
+ * Most fields can have multiple items. The items in a field have no guaranteed
+ * order, but each non-empty field is guaranteed to have exactly one field with
  * `metadata.primary` set to true.
  */
 class Person {
   /** The person's street addresses. */
   core.List<Address> addresses;
   /**
    * The person's age range.
    * Possible string values are:
-   * - "AGE_RANGE_UNSPECIFIED" : A AGE_RANGE_UNSPECIFIED.
-   * - "LESS_THAN_EIGHTEEN" : A LESS_THAN_EIGHTEEN.
-   * - "EIGHTEEN_TO_TWENTY" : A EIGHTEEN_TO_TWENTY.
-   * - "TWENTY_ONE_OR_OLDER" : A TWENTY_ONE_OR_OLDER.
+   * - "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 biographies. */
   core.List<Biography> biographies;
   /** The person's birthdays. */
   core.List<Birthday> birthdays;
   /** The person's bragging rights. */
   core.List<BraggingRights> braggingRights;
   /** The person's cover photos. */
   core.List<CoverPhoto> coverPhotos;
@@ skipping 228 matching lines @@
     if (taglines != null) {
       _json["taglines"] = taglines.map((value) => (value).toJson()).toList();
     }
     if (urls != null) {
       _json["urls"] = urls.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
-/** 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.
    */
   core.bool deleted;
+  /** Resource names of people linked to this resource. */
+  core.List<core.String> linkedPeopleResourceNames;
   /**
    * The type of the person object.
    * Possible string values are:
-   * - "OBJECT_TYPE_UNSPECIFIED" : A OBJECT_TYPE_UNSPECIFIED.
-   * - "PERSON" : A PERSON.
-   * - "PAGE" : A PAGE.
+   * - "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.
+   * 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. */
   core.List<Source> sources;
 
   PersonMetadata();
 
   PersonMetadata.fromJson(core.Map _json) {
     if (_json.containsKey("deleted")) {
       deleted = _json["deleted"];
     }
+    if (_json.containsKey("linkedPeopleResourceNames")) {
+      linkedPeopleResourceNames = _json["linkedPeopleResourceNames"];
+    }
     if (_json.containsKey("objectType")) {
       objectType = _json["objectType"];
     }
     if (_json.containsKey("previousResourceNames")) {
       previousResourceNames = _json["previousResourceNames"];
     }
     if (_json.containsKey("sources")) {
       sources = _json["sources"].map((value) => new Source.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (deleted != null) {
       _json["deleted"] = deleted;
     }
+    if (linkedPeopleResourceNames != null) {
+      _json["linkedPeopleResourceNames"] = linkedPeopleResourceNames;
+    }
     if (objectType != null) {
       _json["objectType"] = objectType;
     }
     if (previousResourceNames != null) {
       _json["previousResourceNames"] = previousResourceNames;
     }
     if (sources != null) {
       _json["sources"] = sources.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /** The response for a single person */
 class PersonResponse {
   /**
    * [HTTP 1.1 status
    * code](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html).
    */
   core.int httpStatusCode;
   /** The person. */
   Person person;
   /**
    * The original requested resource name. May be different than the resource
-   * name on the returned person. The resource name can change when adding or
-   * removing fields that link a contact and profile such as a verified email,
-   * verified phone number, or a profile URL.
+   * 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;
 
   PersonResponse();
 
   PersonResponse.fromJson(core.Map _json) {
     if (_json.containsKey("httpStatusCode")) {
       httpStatusCode = _json["httpStatusCode"];
     }
     if (_json.containsKey("person")) {
@@ skipping 29 matching lines @@
   core.String canonicalForm;
   /**
    * The read-only type of the phone number translated and formatted in the
    * viewer's account locale or the the `Accept-Language` HTTP header locale.
    */
   core.String formattedType;
   /** Metadata about the phone number. */
   FieldMetadata metadata;
   /**
    * The type of the phone number. The type can be custom or predefined.
-   * Possible values include, but are not limited to, the following: * `home` *
-   * `work` * `mobile` * `homeFax` * `workFax` * `otherFax` * `pager` *
-   * `workMobile` * `workPager` * `main` * `googleVoice` * `other`
+   * 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. */
   core.String value;
 
   PhoneNumber();
 
   PhoneNumber.fromJson(core.Map _json) {
     if (_json.containsKey("canonicalForm")) {
       canonicalForm = _json["canonicalForm"];
@@ skipping 27 matching lines @@
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /**
- * A person's 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. */
   FieldMetadata metadata;
   /** The URL of the photo. */
   core.String url;
 
   Photo();
 
   Photo.fromJson(core.Map _json) {
@@ skipping 23 matching lines @@
    * 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. */
   FieldMetadata metadata;
   /** 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`
+   * 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();
 
   Relation.fromJson(core.Map _json) {
     if (_json.containsKey("formattedType")) {
       formattedType = _json["formattedType"];
     }
     if (_json.containsKey("metadata")) {
@@ skipping 18 matching lines @@
     if (person != null) {
       _json["person"] = person;
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
-/** The kind of relationship the person is looking for. */
+/** 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.
+   * viewer's account locale or the locale specified in the Accept-Language
+   * HTTP header.
    */
   core.String formattedValue;
   /** 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`
+   * following values:
+   *
+   * * `friend`
+   * * `date`
+   * * `relationship`
+   * * `networking`
    */
   core.String value;
 
   RelationshipInterest();
 
   RelationshipInterest.fromJson(core.Map _json) {
     if (_json.containsKey("formattedValue")) {
       formattedValue = _json["formattedValue"];
     }
     if (_json.containsKey("metadata")) {
@@ skipping 12 matching lines @@
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
-/** A person's 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.
    */
   core.String formattedValue;
   /** 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();
 
   RelationshipStatus.fromJson(core.Map _json) {
     if (_json.containsKey("formattedValue")) {
       formattedValue = _json["formattedValue"];
     }
     if (_json.containsKey("metadata")) {
@@ skipping 15 matching lines @@
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /** 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. */
   FieldMetadata metadata;
   /** The address of the residence. */
   core.String value;
 
   Residence();
 
   Residence.fromJson(core.Map _json) {
@@ skipping 48 matching lines @@
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /** The source of a field. */
 class Source {
-  /** A unique identifier within the source type generated by the server. */
+  /**
+   * 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.
+   */
+  core.String etag;
+  /** The unique identifier within the source type generated by the server. */
   core.String id;
   /**
+   * The resource name of the source. Only set if there is a separate
+   * resource endpoint.
+   */
+  core.String resourceName;
+  /**
    * The source type.
    * Possible string values are:
-   * - "OTHER" : A OTHER.
-   * - "ACCOUNT" : A ACCOUNT.
-   * - "PROFILE" : A PROFILE.
-   * - "DOMAIN_PROFILE" : A DOMAIN_PROFILE.
-   * - "CONTACT" : A CONTACT.
+   * - "SOURCE_TYPE_UNSPECIFIED" : Unspecified.
+   * - "ACCOUNT" : [Google Account](https://accounts.google.com).
+   * - "PROFILE" : [Google profile](https://profiles.google.com). You can view
+   * the
+   * profile at https://profiles.google.com/<id> where <id> is the source
+   * id.
+   * - "DOMAIN_PROFILE" : [Google Apps domain
+   * profile](https://admin.google.com).
+   * - "CONTACT" : [Google contact](https://contacts.google.com). You can view
+   * the
+   * contact at https://contact.google.com/<id> where <id> is the source
+   * id.
    */
   core.String type;
 
   Source();
 
   Source.fromJson(core.Map _json) {
+    if (_json.containsKey("etag")) {
+      etag = _json["etag"];
+    }
     if (_json.containsKey("id")) {
       id = _json["id"];
     }
+    if (_json.containsKey("resourceName")) {
+      resourceName = _json["resourceName"];
+    }
     if (_json.containsKey("type")) {
       type = _json["type"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (etag != null) {
+      _json["etag"] = etag;
+    }
     if (id != null) {
       _json["id"] = id;
     }
+    if (resourceName != null) {
+      _json["resourceName"] = resourceName;
+    }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
-/** A brief one-line description of the person. */
+/** A read-only brief one-line description of the person. */
 class Tagline {
   /** Metadata about the tagline. */
   FieldMetadata metadata;
   /** The tagline. */
   core.String value;
 
   Tagline();
 
   Tagline.fromJson(core.Map _json) {
     if (_json.containsKey("metadata")) {
@@ skipping 19 matching lines @@
 /** A person's associated URLs. */
 class Url {
   /**
    * The read-only type of the URL translated and formatted in the viewer's
    * account locale or the `Accept-Language` HTTP header locale.
    */
   core.String formattedType;
   /** Metadata about the URL. */
   FieldMetadata metadata;
   /**
-   * 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. */
   core.String value;
 
   Url();
 
   Url.fromJson(core.Map _json) {
     if (_json.containsKey("formattedType")) {
       formattedType = _json["formattedType"];
@@ skipping 19 matching lines @@
     }
     if (type != null) {
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }