Api-roll 21: 2015-08-04

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 22 matching lines @@
    * created with this app
    */
   static const DriveFileScope = "https://www.googleapis.com/auth/drive.file";
 
   /** View and manage metadata of files in your Google Drive */
   static const DriveMetadataScope = "https://www.googleapis.com/auth/drive.metadata";
 
   /** View metadata for files in your Google Drive */
   static const DriveMetadataReadonlyScope = "https://www.googleapis.com/auth/drive.metadata.readonly";
 
+  /** View the photos, videos and albums in your Google Photos */
+  static const DrivePhotosReadonlyScope = "https://www.googleapis.com/auth/drive.photos.readonly";
+
   /** View the files in your Google Drive */
   static const DriveReadonlyScope = "https://www.googleapis.com/auth/drive.readonly";
 
   /** Modify your Google Apps Script scripts' behavior */
   static const DriveScriptsScope = "https://www.googleapis.com/auth/drive.scripts";
 
 
   final commons.ApiRequester _requester;
 
   AboutResourceApi get about => new AboutResourceApi(_requester);
@@ skipping 239 matching lines @@
    * [includeSubscribed] - Whether to include public files the user has opened
    * and shared files. When set to false, the list only includes owned files
    * plus any shared or public files the user has explicitly added to a folder
    * they own.
    *
    * [maxResults] - Maximum number of changes to return.
    *
    * [pageToken] - Page token for changes.
    *
    * [spaces] - A comma-separated list of spaces to query. Supported values are
-   * 'drive' and 'appDataFolder'.
+   * 'drive', 'appDataFolder' and 'photos'.
    *
    * [startChangeId] - Change ID to start listing changes from.
    *
    * Completes with a [ChangeList].
    *
    * 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 49 matching lines @@
    * [includeSubscribed] - Whether to include public files the user has opened
    * and shared files. When set to false, the list only includes owned files
    * plus any shared or public files the user has explicitly added to a folder
    * they own.
    *
    * [maxResults] - Maximum number of changes to return.
    *
    * [pageToken] - Page token for changes.
    *
    * [spaces] - A comma-separated list of spaces to query. Supported values are
-   * 'drive' and 'appDataFolder'.
+   * 'drive', 'appDataFolder' and 'photos'.
    *
    * [startChangeId] - Change ID to start listing changes from.
    *
    * Completes with a [Channel].
    *
    * 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 960 matching lines @@
    * [pageToken] - Page token for files.
    *
    * [projection] - This parameter is deprecated and has no function.
    * Possible string values are:
    * - "BASIC" : Deprecated
    * - "FULL" : Deprecated
    *
    * [q] - Query string for searching files.
    *
    * [spaces] - A comma-separated list of spaces to query. Supported values are
-   * 'drive' and 'appDataFolder'.
+   * 'drive', 'appDataFolder' and 'photos'.
    *
    * Completes with a [FileList].
    *
    * 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<FileList> list({core.String corpus, core.int maxResults, core.String pageToken, core.String projection, core.String q, core.String spaces}) {
@@ skipping 42 matching lines @@
    *
    * Request parameters:
    *
    * [fileId] - The ID of the file to update.
    *
    * [addParents] - Comma-separated list of parent IDs to add.
    *
    * [convert] - Whether to convert this file to the corresponding Google Docs
    * format.
    *
+   * [modifiedDateBehavior] - How the modifiedDate field should be updated. This
+   * overrides setModifiedDate.
+   * Possible string values are:
+   * - "fromBody" : Set modifiedDate to the value provided in the body of the
+   * request. No change if no value was provided.
+   * - "fromBodyIfNeeded" : Set modifiedDate to the value provided in the body
+   * of the request depending on other contents of the update.
+   * - "fromBodyOrNow" : Set modifiedDate to the value provided in the body of
+   * the request, or to the current time if no value was provided.
+   * - "noChange" : Maintain the previous value of modifiedDate.
+   * - "now" : Set modifiedDate to the current time.
+   * - "nowIfNeeded" : Set modifiedDate to the current time depending on
+   * contents of the update.
+   *
    * [newRevision] - Whether a blob upload should create a new revision. If
    * false, the blob data in the current head revision is replaced. If true or
    * not set, a new blob is created as head revision, and previous unpinned
    * revisions are preserved for a short period of time. Pinned revisions are
    * stored indefinitely, using additional storage quota, up to a maximum of 200
    * revisions.
    *
    * [ocr] - Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
    *
    * [ocrLanguage] - If ocr is true, hints at the language to use. Valid values
@@ skipping 17 matching lines @@
    * [useContentAsIndexableText] - Whether to use the content as indexable text.
    *
    * Completes with a [File].
    *
    * 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<File> patch(File request, core.String fileId, {core.String addParents, core.bool convert, core.bool newRevision, core.bool ocr, core.String ocrLanguage, core.bool pinned, core.String removeParents, core.bool setModifiedDate, core.String timedTextLanguage, core.String timedTextTrackName, core.bool updateViewedDate, core.bool useContentAsIndexableText}) {
+  async.Future<File> patch(File request, core.String fileId, {core.String addParents, core.bool convert, core.String modifiedDateBehavior, core.bool newRevision, core.bool ocr, core.String ocrLanguage, core.bool pinned, core.String removeParents, core.bool setModifiedDate, core.String timedTextLanguage, core.String timedTextTrackName, core.bool updateViewedDate, core.bool useContentAsIndexableText}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.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 (addParents != null) {
       _queryParams["addParents"] = [addParents];
     }
     if (convert != null) {
       _queryParams["convert"] = ["${convert}"];
     }
+    if (modifiedDateBehavior != null) {
+      _queryParams["modifiedDateBehavior"] = [modifiedDateBehavior];
+    }
     if (newRevision != null) {
       _queryParams["newRevision"] = ["${newRevision}"];
     }
     if (ocr != null) {
       _queryParams["ocr"] = ["${ocr}"];
     }
     if (ocrLanguage != null) {
       _queryParams["ocrLanguage"] = [ocrLanguage];
     }
     if (pinned != null) {
@@ skipping 63 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new File.fromJson(data));
   }
 
   /**
-   * Moves a file to the trash.
+   * Moves a file to the trash. The currently authenticated user must own the
+   * file.
    *
    * Request parameters:
    *
    * [fileId] - The ID of the file to trash.
    *
    * Completes with a [File].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 70 matching lines @@
    *
    * Request parameters:
    *
    * [fileId] - The ID of the file to update.
    *
    * [addParents] - Comma-separated list of parent IDs to add.
    *
    * [convert] - Whether to convert this file to the corresponding Google Docs
    * format.
    *
+   * [modifiedDateBehavior] - How the modifiedDate field should be updated. This
+   * overrides setModifiedDate.
+   * Possible string values are:
+   * - "fromBody" : Set modifiedDate to the value provided in the body of the
+   * request. No change if no value was provided.
+   * - "fromBodyIfNeeded" : Set modifiedDate to the value provided in the body
+   * of the request depending on other contents of the update.
+   * - "fromBodyOrNow" : Set modifiedDate to the value provided in the body of
+   * the request, or to the current time if no value was provided.
+   * - "noChange" : Maintain the previous value of modifiedDate.
+   * - "now" : Set modifiedDate to the current time.
+   * - "nowIfNeeded" : Set modifiedDate to the current time depending on
+   * contents of the update.
+   *
    * [newRevision] - Whether a blob upload should create a new revision. If
    * false, the blob data in the current head revision is replaced. If true or
    * not set, a new blob is created as head revision, and previous unpinned
    * revisions are preserved for a short period of time. Pinned revisions are
    * stored indefinitely, using additional storage quota, up to a maximum of 200
    * revisions.
    *
    * [ocr] - Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
    *
    * [ocrLanguage] - If ocr is true, hints at the language to use. Valid values
@@ skipping 22 matching lines @@
    * length being known ahead of time is only supported via resumable uploads.
    *
    * Completes with a [File].
    *
    * 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<File> update(File request, core.String fileId, {core.String addParents, core.bool convert, core.bool newRevision, core.bool ocr, core.String ocrLanguage, core.bool pinned, core.String removeParents, core.bool setModifiedDate, core.String timedTextLanguage, core.String timedTextTrackName, core.bool updateViewedDate, core.bool useContentAsIndexableText, commons.UploadOptions uploadOptions : commons.UploadOptions.Default, commons.Media uploadMedia}) {
+  async.Future<File> update(File request, core.String fileId, {core.String addParents, core.bool convert, core.String modifiedDateBehavior, core.bool newRevision, core.bool ocr, core.String ocrLanguage, core.bool pinned, core.String removeParents, core.bool setModifiedDate, core.String timedTextLanguage, core.String timedTextTrackName, core.bool updateViewedDate, core.bool useContentAsIndexableText, commons.UploadOptions uploadOptions : commons.UploadOptions.Default, commons.Media uploadMedia}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.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 (addParents != null) {
       _queryParams["addParents"] = [addParents];
     }
     if (convert != null) {
       _queryParams["convert"] = ["${convert}"];
     }
+    if (modifiedDateBehavior != null) {
+      _queryParams["modifiedDateBehavior"] = [modifiedDateBehavior];
+    }
     if (newRevision != null) {
       _queryParams["newRevision"] = ["${newRevision}"];
     }
     if (ocr != null) {
       _queryParams["ocr"] = ["${ocr}"];
     }
     if (ocrLanguage != null) {
       _queryParams["ocrLanguage"] = [ocrLanguage];
     }
     if (pinned != null) {
@@ skipping 3699 matching lines @@
   /** Whether the file has been shared. */
   core.bool shared;
   /**
    * Time at which this file was shared with the user (formatted RFC 3339
    * timestamp).
    */
   core.DateTime sharedWithMeDate;
   /** User that shared the item with the current user, if available. */
   User sharingUser;
   /**
-   * The list of spaces which contain the file. Supported values are 'drive' and
-   * 'appDataFolder'.
+   * The list of spaces which contain the file. Supported values are 'drive',
+   * 'appDataFolder' and 'photos'.
    */
   core.List<core.String> spaces;
   /**
    * Thumbnail for the file. Only accepted on upload and for files that are not
    * already thumbnailed by Google.
    */
   FileThumbnail thumbnail;
   /**
    * A short-lived link to the file's thumbnail. Typically lasts on the order of
    * hours.
@@ skipping 1189 matching lines @@
     }
     if (permissionId != null) {
       _json["permissionId"] = permissionId;
     }
     if (picture != null) {
       _json["picture"] = (picture).toJson();
     }
     return _json;
   }
 }