Api roll 5: 2014-11-05

generated/googleapis/lib/drive/v2.dart

 library googleapis.drive.v2;
 
 import "dart:core" as core;
 import "dart:collection" as collection;
 import "dart:async" as async;
 import "dart:convert" as convert_1;
 
 import "package:crypto/crypto.dart" as crypto;
 import 'package:http/http.dart' as http;
 import '../src/common_internal.dart' as common_internal;
@@ skipping 1137 matching lines @@
     return _response.then((data) => null);
   }
 
   /**
    * 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.
    * Possible string values are:
    * - "BASIC" : Deprecated
    * - "FULL" : Deprecated
    *
    * [updateViewedDate] - Whether to update the view date after successfully
    * retrieving the file.
    *
-   * Completes with a [File].
+   * [downloadOptions] - Options for downloading. A download can be either a
+   * Metadata (default) or Media download. Partial Media downloads are possible
+   * as well.
+   *
+   * Completes with a
+   *
+   * - [File] for Metadata downloads (see [downloadOptions]).
+   *
+   * - [common.Media] for Media downloads (see [downloadOptions]).
    *
    * Completes with a [common.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<File> get(core.String fileId, {core.String projection, core.bool updateViewedDate}) {
+  async.Future get(core.String fileId, {core.bool acknowledgeAbuse, core.String projection, core.bool updateViewedDate, common.DownloadOptions downloadOptions: common.DownloadOptions.Metadata}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = common.DownloadOptions.Metadata;
     var _body = null;
 
     if (fileId == null) {
       throw new core.ArgumentError("Parameter fileId is required.");
     }
+    if (acknowledgeAbuse != null) {
+      _queryParams["acknowledgeAbuse"] = ["${acknowledgeAbuse}"];
+    }
     if (projection != null) {
       _queryParams["projection"] = [projection];
     }
     if (updateViewedDate != null) {
       _queryParams["updateViewedDate"] = ["${updateViewedDate}"];
     }
 
+    _downloadOptions = downloadOptions;
 
     _url = 'files/' + common_internal.Escaper.ecapeVariable('$fileId');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
-    return _response.then((data) => new File.fromJson(data));
+    if (_downloadOptions == null ||
+        _downloadOptions == common.DownloadOptions.Metadata) {
+      return _response.then((data) => new File.fromJson(data));
+    } else {
+      return _response;
+    }
   }
 
   /**
    * Insert a new file.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [convert] - Whether to convert this file to the corresponding Google Docs
@@ skipping 519 matching lines @@
 
   /**
    * Subscribe to changes on a file
    *
    * [request] - The metadata request object.
    *
    * 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.
    * Possible string values are:
    * - "BASIC" : Deprecated
    * - "FULL" : Deprecated
    *
    * [updateViewedDate] - Whether to update the view date after successfully
    * retrieving the file.
    *
-   * Completes with a [Channel].
+   * [downloadOptions] - Options for downloading. A download can be either a
+   * Metadata (default) or Media download. Partial Media downloads are possible
+   * as well.
+   *
+   * Completes with a
+   *
+   * - [Channel] for Metadata downloads (see [downloadOptions]).
+   *
+   * - [common.Media] for Media downloads (see [downloadOptions]).
    *
    * Completes with a [common.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<Channel> watch(Channel request, core.String fileId, {core.String projection, core.bool updateViewedDate}) {
+  async.Future watch(Channel request, core.String fileId, {core.bool acknowledgeAbuse, core.String projection, core.bool updateViewedDate, common.DownloadOptions downloadOptions: common.DownloadOptions.Metadata}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = common.DownloadOptions.Metadata;
     var _body = null;
 
     if (request != null) {
       _body = convert_1.JSON.encode((request).toJson());
     }
     if (fileId == null) {
       throw new core.ArgumentError("Parameter fileId is required.");
     }
+    if (acknowledgeAbuse != null) {
+      _queryParams["acknowledgeAbuse"] = ["${acknowledgeAbuse}"];
+    }
     if (projection != null) {
       _queryParams["projection"] = [projection];
     }
     if (updateViewedDate != null) {
       _queryParams["updateViewedDate"] = ["${updateViewedDate}"];
     }
 
+    _downloadOptions = downloadOptions;
 
     _url = 'files/' + common_internal.Escaper.ecapeVariable('$fileId') + '/watch';
 
     var _response = _requester.request(_url,
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
-    return _response.then((data) => new Channel.fromJson(data));
+    if (_downloadOptions == null ||
+        _downloadOptions == common.DownloadOptions.Metadata) {
+      return _response.then((data) => new Channel.fromJson(data));
+    } else {
+      return _response;
+    }
   }
 
 }
 
 
 /** Not documented yet. */
 class ParentsResourceApi {
   final common_internal.ApiRequester _requester;
 
   ParentsResourceApi(common_internal.ApiRequester client) : 
@@ skipping 5067 matching lines @@
       _json["permissionId"] = permissionId;
     }
     if (picture != null) {
       _json["picture"] = (picture).toJson();
     }
     return _json;
   }
 }