Api-Roll 53: 2017-08-21

generated/googleapis/lib/storage/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.storage.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 1548 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Notification.fromJson(data));
   }
 
   /**
    * Retrieves a list of notification subscriptions for a given bucket.
    *
    * Request parameters:
    *
-   * [bucket] - Name of a GCS bucket.
+   * [bucket] - Name of a Google Cloud Storage bucket.
    *
    * [userProject] - The project to be billed for this request, for Requester
    * Pays buckets.
    *
    * Completes with a [Notifications].
    *
    * 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,
@@ skipping 453 matching lines @@
    * team owners get OWNER access.
    * - "bucketOwnerRead" : Object owner gets OWNER access, and project team
    * owners get READER access.
    * - "private" : Object owner gets OWNER access.
    * - "projectPrivate" : Object owner gets OWNER access, and project team
    * members get access according to their roles.
    * - "publicRead" : Object owner gets OWNER access, and allUsers get READER
    * access.
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * object's current generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * object's current metageneration matches the given value.
    *
    * [kmsKeyName] - Resource name of the Cloud KMS key, of the form
    * projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that
    * will be used to encrypt the object. Overrides the object metadata's
    * kms_key_name value, if any.
    *
    * [userProject] - The project to be billed for this request, for Requester
@@ skipping 98 matching lines @@
    * team owners get OWNER access.
    * - "bucketOwnerRead" : Object owner gets OWNER access, and project team
    * owners get READER access.
    * - "private" : Object owner gets OWNER access.
    * - "projectPrivate" : Object owner gets OWNER access, and project team
    * members get access according to their roles.
    * - "publicRead" : Object owner gets OWNER access, and allUsers get READER
    * access.
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * destination object's current generation matches the given value.
+   * destination object's current generation matches the given value. Setting to
+   * 0 makes the operation succeed only if there are no live versions of the
+   * object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * destination object's current generation does not match the given value.
+   * destination object's current generation does not match the given value. If
+   * no live object exists, the precondition fails. Setting to 0 makes the
+   * operation succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * destination object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * destination object's current metageneration does not match the given value.
    *
    * [ifSourceGenerationMatch] - Makes the operation conditional on whether the
-   * source object's generation matches the given value.
+   * source object's current generation matches the given value.
    *
    * [ifSourceGenerationNotMatch] - Makes the operation conditional on whether
-   * the source object's generation does not match the given value.
+   * the source object's current generation does not match the given value.
    *
    * [ifSourceMetagenerationMatch] - Makes the operation conditional on whether
    * the source object's current metageneration matches the given value.
    *
    * [ifSourceMetagenerationNotMatch] - Makes the operation conditional on
    * whether the source object's current metageneration does not match the given
    * value.
    *
    * [projection] - Set of properties to return. Defaults to noAcl, unless the
    * object resource specifies the acl property, when it defaults to full.
@@ skipping 110 matching lines @@
    *
    * [bucket] - Name of the bucket in which the object resides.
    *
    * [object] - Name of the object. For information about how to URL encode
    * object names to be path safe, see Encoding URI Path Parts.
    *
    * [generation] - If present, permanently deletes a specific revision of this
    * object (as opposed to the latest version, the default).
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * object's current generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * object's current generation does not match the given value.
+   * object's current generation does not match the given value. If no live
+   * object exists, the precondition fails. Setting to 0 makes the operation
+   * succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * object's current metageneration does not match the given value.
    *
    * [userProject] - The project to be billed for this request, for Requester
    * Pays buckets.
    *
@@ skipping 57 matching lines @@
    *
    * [bucket] - Name of the bucket in which the object resides.
    *
    * [object] - Name of the object. For information about how to URL encode
    * object names to be path safe, see Encoding URI Path Parts.
    *
    * [generation] - If present, selects a specific revision of this object (as
    * opposed to the latest version, the default).
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * object's generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * object's generation does not match the given value.
+   * object's current generation does not match the given value. If no live
+   * object exists, the precondition fails. Setting to 0 makes the operation
+   * succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * object's current metageneration does not match the given value.
    *
    * [projection] - Set of properties to return. Defaults to noAcl.
    * Possible string values are:
    * - "full" : Include all properties.
@@ skipping 140 matching lines @@
    * [bucket] - Name of the bucket in which to store the new object. Overrides
    * the provided object metadata's bucket value, if any.
    *
    * [contentEncoding] - If set, sets the contentEncoding property of the final
    * object to this value. Setting this parameter is equivalent to setting the
    * contentEncoding metadata property. This can be useful when uploading an
    * object with uploadType=media to indicate the encoding of the content being
    * uploaded.
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * object's current generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * object's current generation does not match the given value.
+   * object's current generation does not match the given value. If no live
+   * object exists, the precondition fails. Setting to 0 makes the operation
+   * succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * object's current metageneration does not match the given value.
    *
    * [kmsKeyName] - Resource name of the Cloud KMS key, of the form
    * projects/my-project/locations/global/keyRings/my-kr/cryptoKeys/my-key, that
    * will be used to encrypt the object. Overrides the object metadata's
@@ skipping 218 matching lines @@
    *
    * [bucket] - Name of the bucket in which the object resides.
    *
    * [object] - Name of the object. For information about how to URL encode
    * object names to be path safe, see Encoding URI Path Parts.
    *
    * [generation] - If present, selects a specific revision of this object (as
    * opposed to the latest version, the default).
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * object's current generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * object's current generation does not match the given value.
+   * object's current generation does not match the given value. If no live
+   * object exists, the precondition fails. Setting to 0 makes the operation
+   * succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * object's current metageneration does not match the given value.
    *
    * [predefinedAcl] - Apply a predefined set of access controls to this object.
    * Possible string values are:
    * - "authenticatedRead" : Object owner gets OWNER access, and
@@ skipping 113 matching lines @@
    * team owners get OWNER access.
    * - "bucketOwnerRead" : Object owner gets OWNER access, and project team
    * owners get READER access.
    * - "private" : Object owner gets OWNER access.
    * - "projectPrivate" : Object owner gets OWNER access, and project team
    * members get access according to their roles.
    * - "publicRead" : Object owner gets OWNER access, and allUsers get READER
    * access.
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * destination object's current generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * destination object's current generation does not match the given value.
+   * object's current generation does not match the given value. If no live
+   * object exists, the precondition fails. Setting to 0 makes the operation
+   * succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * destination object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * destination object's current metageneration does not match the given value.
    *
    * [ifSourceGenerationMatch] - Makes the operation conditional on whether the
-   * source object's generation matches the given value.
+   * source object's current generation matches the given value.
    *
    * [ifSourceGenerationNotMatch] - Makes the operation conditional on whether
-   * the source object's generation does not match the given value.
+   * the source object's current generation does not match the given value.
    *
    * [ifSourceMetagenerationMatch] - Makes the operation conditional on whether
    * the source object's current metageneration matches the given value.
    *
    * [ifSourceMetagenerationNotMatch] - Makes the operation conditional on
    * whether the source object's current metageneration does not match the given
    * value.
    *
    * [maxBytesRewrittenPerCall] - The maximum number of bytes that will be
    * rewritten per rewrite request. Most callers shouldn't need to specify this
@@ skipping 245 matching lines @@
    *
    * [bucket] - Name of the bucket in which the object resides.
    *
    * [object] - Name of the object. For information about how to URL encode
    * object names to be path safe, see Encoding URI Path Parts.
    *
    * [generation] - If present, selects a specific revision of this object (as
    * opposed to the latest version, the default).
    *
    * [ifGenerationMatch] - Makes the operation conditional on whether the
-   * object's current generation matches the given value.
+   * object's current generation matches the given value. Setting to 0 makes the
+   * operation succeed only if there are no live versions of the object.
    *
    * [ifGenerationNotMatch] - Makes the operation conditional on whether the
-   * object's current generation does not match the given value.
+   * object's current generation does not match the given value. If no live
+   * object exists, the precondition fails. Setting to 0 makes the operation
+   * succeed only if there is a live version of the object.
    *
    * [ifMetagenerationMatch] - Makes the operation conditional on whether the
    * object's current metageneration matches the given value.
    *
    * [ifMetagenerationNotMatch] - Makes the operation conditional on whether the
    * object's current metageneration does not match the given value.
    *
    * [predefinedAcl] - Apply a predefined set of access controls to this object.
    * Possible string values are:
    * - "authenticatedRead" : Object owner gets OWNER access, and
@@ skipping 198 matching lines @@
 }
 
 
 class ProjectsServiceAccountResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsServiceAccountResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Get the email address of this project's GCS service account.
+   * Get the email address of this project's Google Cloud Storage service
+   * account.
    *
    * Request parameters:
    *
    * [projectId] - Project ID
    *
    * Completes with a [ServiceAccount].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 1302 matching lines @@
    * accumulated by compose operations.
    */
   core.int componentCount;
   /** Content-Disposition of the object data. */
   core.String contentDisposition;
   /** Content-Encoding of the object data. */
   core.String contentEncoding;
   /** Content-Language of the object data. */
   core.String contentLanguage;
   /**
-   * Content-Type of the object data. If contentType is not specified, object
-   * downloads will be served as application/octet-stream.
+   * Content-Type of the object data. If an object is stored without a
+   * Content-Type, it is served as application/octet-stream.
    */
   core.String contentType;
   /**
    * CRC32c checksum, as described in RFC 4960, Appendix B; encoded using base64
    * in big-endian byte order. For more information about using the CRC32c
    * checksum, see Hashes and ETags: Best Practices.
    */
   core.String crc32c;
   /**
    * Metadata of customer-supplied encryption key, if the object is encrypted by
@@ skipping 585 matching lines @@
   void set etagAsBytes(core.List<core.int> _bytes) {
     etag = convert.BASE64.encode(_bytes).replaceAll("/", "_").replaceAll("+", "-");
   }
   /**
    * The kind of item this is. For policies, this is always storage#policy. This
    * field is ignored on input.
    */
   core.String kind;
   /**
    * The ID of the resource to which this policy belongs. Will be of the form
-   * buckets/bucket for buckets, and buckets/bucket/objects/object for objects.
-   * A specific generation may be specified by appending #generationNumber to
-   * the end of the object name, e.g. buckets/my-bucket/objects/data.txt#17. The
-   * current generation can be denoted with #0. This field is ignored on input.
+   * projects/_/buckets/bucket for buckets, and
+   * projects/_/buckets/bucket/objects/object for objects. A specific generation
+   * may be specified by appending #generationNumber to the end of the object
+   * name, e.g. projects/_/buckets/my-bucket/objects/data.txt#17. The current
+   * generation can be denoted with #0. This field is ignored on input.
    */
   core.String resourceId;
 
   Policy();
 
   Policy.fromJson(core.Map _json) {
     if (_json.containsKey("bindings")) {
       bindings = _json["bindings"].map((value) => new PolicyBindings.fromJson(value)).toList();
     }
     if (_json.containsKey("etag")) {
@@ skipping 175 matching lines @@
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (kind != null) {
       _json["kind"] = kind;
     }
     if (permissions != null) {
       _json["permissions"] = permissions;
     }
     return _json;
   }
 }