Api-roll 46: 2017-03-06

generated/googleapis/lib/people/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.people.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 38 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;
 
-  PeopleMeResourceApi get me => new PeopleMeResourceApi(_requester);
+  PeopleConnectionsResourceApi get connections => new PeopleConnectionsResourceApi(_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:
    *
@@ skipping 100 matching lines @@
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new GetPeopleResponse.fromJson(data));
   }
 
 }
 
 
-class PeopleMeResourceApi {
+class PeopleConnectionsResourceApi {
   final commons.ApiRequester _requester;
 
-  PeopleMeConnectionsResourceApi get connections => new PeopleMeConnectionsResourceApi(_requester);
-
-  PeopleMeResourceApi(commons.ApiRequester client) : 
-      _requester = client;
-}
-
-
-class PeopleMeConnectionsResourceApi {
-  final commons.ApiRequester _requester;
-
-  PeopleMeConnectionsResourceApi(commons.ApiRequester client) : 
+  PeopleConnectionsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Provides a list of the authenticated user's contacts merged with any
    * linked profiles.
    *
    * Request parameters:
    *
-   * [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.
+   * [resourceName] - The resource name to return connections for. Only
+   * `people/me` is valid.
+   * Value must have pattern "^people/[^/]+$".
    *
-   * [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.
+   * [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 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 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`.
    *
+   * [pageSize] - The number of connections to include in the response. Valid
+   * values are
+   * between 1 and 500, 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.
+   *
+   * [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.
+   *
    * 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 sortOrder, core.String syncToken, core.String pageToken, core.int pageSize, core.String requestMask_includeField}) {
+  async.Future<ListConnectionsResponse> list(core.String resourceName, {core.bool requestSyncToken, core.String pageToken, core.String requestMask_includeField, core.int pageSize, core.String syncToken, core.String sortOrder}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-    if (sortOrder != null) {
-      _queryParams["sortOrder"] = [sortOrder];
+    if (resourceName == null) {
+      throw new core.ArgumentError("Parameter resourceName is required.");
+    }
+    if (requestSyncToken != null) {
+      _queryParams["requestSyncToken"] = ["${requestSyncToken}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+    if (requestMask_includeField != null) {
+      _queryParams["requestMask.includeField"] = [requestMask_includeField];
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (syncToken != null) {
       _queryParams["syncToken"] = [syncToken];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
-    if (requestMask_includeField != null) {
-      _queryParams["requestMask.includeField"] = [requestMask_includeField];
+    if (sortOrder != null) {
+      _queryParams["sortOrder"] = [sortOrder];
     }
 
-    _url = 'v1/people/me/connections';
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$resourceName') + '/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 126 matching lines @@
     if (streetAddress != null) {
       _json["streetAddress"] = streetAddress;
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
+/** 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.
+   */
+  core.String ageRange;
+  /** Metadata about the age range. */
+  FieldMetadata metadata;
+
+  AgeRangeType();
+
+  AgeRangeType.fromJson(core.Map _json) {
+    if (_json.containsKey("ageRange")) {
+      ageRange = _json["ageRange"];
+    }
+    if (_json.containsKey("metadata")) {
+      metadata = new FieldMetadata.fromJson(_json["metadata"]);
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (ageRange != null) {
+      _json["ageRange"] = ageRange;
+    }
+    if (metadata != null) {
+      _json["metadata"] = (metadata).toJson();
+    }
+    return _json;
+  }
+}
+
 /** A person's short biography. */
 class Biography {
   /**
    * The content type of the biography.
    * Possible string values are:
    * - "CONTENT_TYPE_UNSPECIFIED" : Unspecified.
    * - "TEXT_PLAIN" : Plain text.
    * - "TEXT_HTML" : HTML text.
    */
   core.String contentType;
@@ skipping 1073 matching lines @@
 }
 
 /**
  * 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.primary` set to true.
+ * NEXT_ID: 31
  */
 class Person {
   /** The person's street addresses. */
   core.List<Address> addresses;
   /**
-   * The person's age range.
+   * DEPRECATED(Please read person.age_ranges instead). The person's age range.
    * Possible string values are:
    * - "AGE_RANGE_UNSPECIFIED" : Unspecified.
    * - "LESS_THAN_EIGHTEEN" : Younger than eighteen.
    * - "EIGHTEEN_TO_TWENTY" : Between eighteen and twenty.
    * - "TWENTY_ONE_OR_OLDER" : Twenty-one and older.
    */
   core.String ageRange;
+  /** The person's age ranges. */
+  core.List<AgeRangeType> ageRanges;
   /** The person's biographies. */
   core.List<Biography> biographies;
   /** The person's birthdays. */
   core.List<Birthday> birthdays;
   /** The person's bragging rights. */
   core.List<BraggingRights> braggingRights;
   /** The person's cover photos. */
   core.List<CoverPhoto> coverPhotos;
   /** The person's email addresses. */
   core.List<EmailAddress> emailAddresses;
@@ skipping 50 matching lines @@
 
   Person();
 
   Person.fromJson(core.Map _json) {
     if (_json.containsKey("addresses")) {
       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();
+    }
     if (_json.containsKey("biographies")) {
       biographies = _json["biographies"].map((value) => new Biography.fromJson(value)).toList();
     }
     if (_json.containsKey("birthdays")) {
       birthdays = _json["birthdays"].map((value) => new Birthday.fromJson(value)).toList();
     }
     if (_json.containsKey("braggingRights")) {
       braggingRights = _json["braggingRights"].map((value) => new BraggingRights.fromJson(value)).toList();
     }
     if (_json.containsKey("coverPhotos")) {
@@ skipping 71 matching lines @@
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (addresses != null) {
       _json["addresses"] = addresses.map((value) => (value).toJson()).toList();
     }
     if (ageRange != null) {
       _json["ageRange"] = ageRange;
     }
+    if (ageRanges != null) {
+      _json["ageRanges"] = ageRanges.map((value) => (value).toJson()).toList();
+    }
     if (biographies != null) {
       _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();
     }
     if (coverPhotos != null) {
@@ skipping 76 matching lines @@
 class PersonMetadata {
   /**
    * True if the person resource has been deleted. Populated only for
    * [`connections.list`](/people/api/rest/v1/people.connections/list) requests
    * that include a sync token.
    */
   core.bool deleted;
   /** Resource names of people linked to this resource. */
   core.List<core.String> linkedPeopleResourceNames;
   /**
+   * DEPRECATED(Please read person.metadata.sources.profile_metadata instead).
    * The type of the person object.
    * Possible string values are:
    * - "OBJECT_TYPE_UNSPECIFIED" : Unspecified.
    * - "PERSON" : Person.
    * - "PAGE" : [Google+ Page.](http://www.google.com/+/brands/)
    */
   core.String objectType;
   /**
    * Any former resource names this person has had. Populated only for
    * [`connections.list`](/people/api/rest/v1/people.connections/list) requests
@@ skipping 199 matching lines @@
     if (metadata != null) {
       _json["metadata"] = (metadata).toJson();
     }
     if (url != null) {
       _json["url"] = url;
     }
     return _json;
   }
 }
 
+/** The read-only metadata about a profile. */
+class ProfileMetadata {
+  /**
+   * The profile object type.
+   * Possible string values are:
+   * - "OBJECT_TYPE_UNSPECIFIED" : Unspecified.
+   * - "PERSON" : Person.
+   * - "PAGE" : [Google+ Page.](http://www.google.com/+/brands/)
+   */
+  core.String objectType;
+
+  ProfileMetadata();
+
+  ProfileMetadata.fromJson(core.Map _json) {
+    if (_json.containsKey("objectType")) {
+      objectType = _json["objectType"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (objectType != null) {
+      _json["objectType"] = objectType;
+    }
+    return _json;
+  }
+}
+
 /** A person's relation to another person. */
 class Relation {
   /**
    * The type of the relation translated and formatted in the viewer's account
    * locale or the locale specified in the Accept-Language HTTP header.
    */
   core.String formattedType;
   /** Metadata about the relation. */
   FieldMetadata metadata;
   /** The name of the other person this relation refers to. */
@@ skipping 234 matching lines @@
 /** The source of a field. */
 class Source {
   /**
    * 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;
+  /** Metadata about a source of type PROFILE. */
+  ProfileMetadata profileMetadata;
   /**
    * The source type.
    * Possible string values are:
    * - "SOURCE_TYPE_UNSPECIFIED" : Unspecified.
    * - "ACCOUNT" : [Google Account](https://accounts.google.com).
    * - "PROFILE" : [Google profile](https://profiles.google.com). You can view
    * the
    * profile at https://profiles.google.com/<id> where <id> is the source
    * id.
    * - "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("profileMetadata")) {
+      profileMetadata = new ProfileMetadata.fromJson(_json["profileMetadata"]);
     }
     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 (profileMetadata != null) {
+      _json["profileMetadata"] = (profileMetadata).toJson();
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /** A read-only brief one-line description of the person. */
 class Tagline {
@@ skipping 79 matching lines @@
     }
     if (type != null) {
       _json["type"] = type;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }