Api-roll 22: 2015-08-17

generated/googleapis/lib/drive/v2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.drive.v2;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert_1;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:crypto/crypto.dart' as crypto;
@@ skipping 1132 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
+   * Generates a set of file IDs which can be provided in insert requests.
+   *
+   * Request parameters:
+   *
+   * [maxResults] - Maximum number of IDs to return.
+   * Value must be between "1" and "1000".
+   *
+   * [space] - The space in which the IDs can be used to create new files.
+   * Supported values are 'drive' and 'appDataFolder'.
+   *
+   * Completes with a [GeneratedIds].
+   *
+   * 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<GeneratedIds> generateIds({core.int maxResults, core.String space}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (maxResults != null) {
+      _queryParams["maxResults"] = ["${maxResults}"];
+    }
+    if (space != null) {
+      _queryParams["space"] = [space];
+    }
+
+    _url = 'files/generateIds';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new GeneratedIds.fromJson(data));
+  }
+
+  /**
    * Gets a file's metadata by ID.
    *
    * Request parameters:
    *
    * [fileId] - The ID for the file in question.
    *
    * [acknowledgeAbuse] - Whether the user is acknowledging the risk of
    * downloading known malware or other abusive files.
    *
    * [projection] - This parameter is deprecated and has no function.
@@ skipping 2449 matching lines @@
 
 /** An item with user information and settings. */
 class About {
   /**
    * Information about supported additional roles per file type. The most
    * specific type takes precedence.
    */
   core.List<AboutAdditionalRoleInfo> additionalRoleInfo;
   /**
    * The domain sharing policy for the current user. Possible values are:
-   * - ALLOWED
-   * - ALLOWED_WITH_WARNING
-   * - INCOMING_ONLY
-   * - DISALLOWED
+   * - allowed
+   * - allowedWithWarning
+   * - incomingOnly
+   * - disallowed
    */
   core.String domainSharingPolicy;
   /** The ETag of the item. */
   core.String etag;
   /** The allowable export formats. */
   core.List<AboutExportFormats> exportFormats;
   /** List of additional features enabled on this account. */
   core.List<AboutFeatures> features;
   /** The palette of allowable folder colors as RGB hex strings. */
   core.List<core.String> folderColorPalette;
@@ skipping 1701 matching lines @@
   /** ETag of the file. */
   core.String etag;
   /**
    * Whether this file has been explicitly trashed, as opposed to recursively
    * trashed.
    */
   core.bool explicitlyTrashed;
   /** Links for exporting Google Docs to specific formats. */
   core.Map<core.String, core.String> exportLinks;
   /**
-   * The file extension used when downloading this file. This field is read
-   * only. To set the extension, include it in the title when creating the file.
-   * This is only populated for files with content stored in Drive.
+   * The final component of fullFileExtension with trailing text that does not
+   * appear to be part of the extension removed. This field is only populated
+   * for files with content stored in Drive; it is not populated for Google Docs
+   * or shortcut files.
    */
   core.String fileExtension;
   /**
-   * The size of the file in bytes. This is only populated for files with
-   * content stored in Drive.
+   * The size of the file in bytes. This field is only populated for files with
+   * content stored in Drive; it is not populated for Google Docs or shortcut
+   * files.
    */
   core.String fileSize;
   /**
    * Folder color as an RGB hex string if the file is a folder. The list of
    * supported colors is available in the folderColorPalette field of the About
    * resource. If an unsupported color is specified, it will be changed to the
    * closest color in the palette.
    */
   core.String folderColorRgb;
   /**
-   * The ID of the file's head revision. This will only be populated for files
-   * with content stored in Drive.
+   * The full file extension; extracted from the title. May contain multiple
+   * concatenated extensions, such as "tar.gz". Removing an extension from the
+   * title does not clear this field; however, changing the extension on the
+   * title does update this field. This field is only populated for files with
+   * content stored in Drive; it is not populated for Google Docs or shortcut
+   * files.
+   */
+  core.String fullFileExtension;
+  /**
+   * The ID of the file's head revision. This field is only populated for files
+   * with content stored in Drive; it is not populated for Google Docs or
+   * shortcut files.
    */
   core.String headRevisionId;
   /** A link to the file's icon. */
   core.String iconLink;
   /** The ID of the file. */
   core.String id;
   /**
    * Metadata about image media. This will only be present for image types, and
    * its contents will depend on what can be parsed from the image content.
    */
@@ skipping 11 matching lines @@
   /**
    * Last time this file was viewed by the user (formatted RFC 3339 timestamp).
    */
   core.DateTime lastViewedByMeDate;
   /**
    * Time this file was explicitly marked viewed by the user (formatted RFC 3339
    * timestamp).
    */
   core.DateTime markedViewedByMeDate;
   /**
-   * An MD5 checksum for the content of this file. This is populated only for
-   * files with content stored in Drive.
+   * An MD5 checksum for the content of this file. This field is only populated
+   * for files with content stored in Drive; it is not populated for Google Docs
+   * or shortcut files.
    */
   core.String md5Checksum;
   /**
    * The MIME type of the file. This is only mutable on update when uploading
    * new content. This field can be left blank, and the mimetype will be
    * determined from the uploaded content's MIME type.
    */
   core.String mimeType;
   /**
    * Last time this file was modified by the user (formatted RFC 3339
    * timestamp). Note that setting modifiedDate will also update the
    * modifiedByMe date for the user which set the date.
    */
   core.DateTime modifiedByMeDate;
   /**
    * Last time this file was modified by anyone (formatted RFC 3339 timestamp).
    * This is only mutable on update when the setModifiedDate parameter is set.
    */
   core.DateTime modifiedDate;
   /**
    * A map of the id of each of the user's apps to a link to open this file with
    * that app. Only populated when the drive.apps.readonly scope is used.
    */
   core.Map<core.String, core.String> openWithLinks;
   /**
    * The original filename if the file was uploaded manually, or the original
    * title if the file was inserted through the API. Note that renames of the
-   * title will not change the original filename. This will only be populated on
-   * files with content stored in Drive.
+   * title will not change the original filename. This field is only populated
+   * for files with content stored in Drive; it is not populated for Google Docs
+   * or shortcut files.
    */
   core.String originalFilename;
   /** Whether the file is owned by the current user. */
   core.bool ownedByMe;
   /** Name(s) of the owner(s) of this file. */
   core.List<core.String> ownerNames;
   /** The owner(s) of this file. */
   core.List<User> owners;
   /**
    * Collection of parent folders which contain this file.
@@ skipping 108 matching lines @@
     }
     if (_json.containsKey("fileExtension")) {
       fileExtension = _json["fileExtension"];
     }
     if (_json.containsKey("fileSize")) {
       fileSize = _json["fileSize"];
     }
     if (_json.containsKey("folderColorRgb")) {
       folderColorRgb = _json["folderColorRgb"];
     }
+    if (_json.containsKey("fullFileExtension")) {
+      fullFileExtension = _json["fullFileExtension"];
+    }
     if (_json.containsKey("headRevisionId")) {
       headRevisionId = _json["headRevisionId"];
     }
     if (_json.containsKey("iconLink")) {
       iconLink = _json["iconLink"];
     }
     if (_json.containsKey("id")) {
       id = _json["id"];
     }
     if (_json.containsKey("imageMediaMetadata")) {
@@ skipping 149 matching lines @@
     }
     if (fileExtension != null) {
       _json["fileExtension"] = fileExtension;
     }
     if (fileSize != null) {
       _json["fileSize"] = fileSize;
     }
     if (folderColorRgb != null) {
       _json["folderColorRgb"] = folderColorRgb;
     }
+    if (fullFileExtension != null) {
+      _json["fullFileExtension"] = fullFileExtension;
+    }
     if (headRevisionId != null) {
       _json["headRevisionId"] = headRevisionId;
     }
     if (iconLink != null) {
       _json["iconLink"] = iconLink;
     }
     if (id != null) {
       _json["id"] = id;
     }
     if (imageMediaMetadata != null) {
@@ skipping 163 matching lines @@
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
+/** A list of generated IDs which can be provided in insert requests */
+class GeneratedIds {
+  /** The IDs generated for the requesting user in the specified space. */
+  core.List<core.String> ids;
+  /** This is always drive#generatedIds */
+  core.String kind;
+  /** The type of file that can be created with these IDs. */
+  core.String space;
+
+  GeneratedIds();
+
+  GeneratedIds.fromJson(core.Map _json) {
+    if (_json.containsKey("ids")) {
+      ids = _json["ids"];
+    }
+    if (_json.containsKey("kind")) {
+      kind = _json["kind"];
+    }
+    if (_json.containsKey("space")) {
+      space = _json["space"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (ids != null) {
+      _json["ids"] = ids;
+    }
+    if (kind != null) {
+      _json["kind"] = kind;
+    }
+    if (space != null) {
+      _json["space"] = space;
+    }
+    return _json;
+  }
+}
+
 /** A list of a file's parents. */
 class ParentList {
   /** The ETag of the list. */
   core.String etag;
   /** The actual list of parents. */
   core.List<ParentReference> items;
   /** This is always drive#parentList. */
   core.String kind;
   /** A link back to this list. */
   core.String selfLink;
@@ skipping 748 matching lines @@
     }
     if (permissionId != null) {
       _json["permissionId"] = permissionId;
     }
     if (picture != null) {
       _json["picture"] = (picture).toJson();
     }
     return _json;
   }
 }