Api-Roll 53: 2017-08-21

discovery/googleapis/storage__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/cloud-platform.read-only": {
                     "description": "View your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/devstorage.full_control": {
                     "description": "Manage your data and permissions in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_only": {
                     "description": "View your data in Google Cloud Storage"
                 },
                 "https://www.googleapis.com/auth/devstorage.read_write": {
                     "description": "Manage your data in Google Cloud Storage"
                 }
             }
         }
     },
     "basePath": "/storage/v1/",
     "baseUrl": "https://www.googleapis.com/storage/v1/",
     "batchPath": "batch",
     "description": "Stores and retrieves potentially large, immutable data objects.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/storage/docs/json_api/",
-    "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/-XlPsGE1eaKzlxWDtbwmuSaBoqc\"",
+    "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/tlgWHRfLf7fwkqtOCpLemeoORxg\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png",
         "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png"
     },
     "id": "storage:v1",
     "kind": "discovery#restDescription",
     "labels": [
         "labs"
     ],
     "name": "storage",
@@ skipping 1151 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves a list of notification subscriptions for a given bucket.",
                     "httpMethod": "GET",
                     "id": "storage.notifications.list",
                     "parameterOrder": [
                         "bucket"
                     ],
                     "parameters": {
                         "bucket": {
-                            "description": "Name of a GCS bucket.",
+                            "description": "Name of a Google Cloud Storage bucket.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "userProject": {
                             "description": "The project to be billed for this request, for Requester Pays buckets.",
                             "location": "query",
                             "type": "string"
                         }
                     },
@@ skipping 339 matching lines @@
                                 "Object owner gets OWNER access, and project team owners get OWNER access.",
                                 "Object owner gets OWNER access, and project team owners get READER access.",
                                 "Object owner gets OWNER access.",
                                 "Object owner gets OWNER access, and project team members get access according to their roles.",
                                 "Object owner gets OWNER access, and allUsers get READER access."
                             ],
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 60 matching lines @@
                                 "Object owner gets OWNER access, and project team owners get OWNER access.",
                                 "Object owner gets OWNER access, and project team owners get READER access.",
                                 "Object owner gets OWNER access.",
                                 "Object owner gets OWNER access, and project team members get access according to their roles.",
                                 "Object owner gets OWNER access, and allUsers get READER access."
                             ],
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the destination object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the destination object's current generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the destination object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationNotMatch": {
                             "description": "Makes the operation conditional on whether the destination object's current metageneration does not match the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifSourceGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the source object's generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the source object's current generation matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifSourceGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the source object's generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the source object's current generation does not match the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifSourceMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the source object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 69 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "generation": {
                             "description": "If present, permanently deletes a specific revision of this object (as opposed to the latest version, the default).",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 37 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "generation": {
                             "description": "If present, selects a specific revision of this object (as opposed to the latest version, the default).",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the object's generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the object's generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 114 matching lines @@
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "contentEncoding": {
                             "description": "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.",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 157 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "generation": {
                             "description": "If present, selects a specific revision of this object (as opposed to the latest version, the default).",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 104 matching lines @@
                                 "Object owner gets OWNER access, and project team owners get OWNER access.",
                                 "Object owner gets OWNER access, and project team owners get READER access.",
                                 "Object owner gets OWNER access.",
                                 "Object owner gets OWNER access, and project team members get access according to their roles.",
                                 "Object owner gets OWNER access, and allUsers get READER access."
                             ],
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the destination object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the destination object's current generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the destination object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationNotMatch": {
                             "description": "Makes the operation conditional on whether the destination object's current metageneration does not match the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifSourceGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the source object's generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the source object's current generation matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifSourceGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the source object's generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the source object's current generation does not match the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifSourceMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the source object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 178 matching lines @@
                             "required": true,
                             "type": "string"
                         },
                         "generation": {
                             "description": "If present, selects a specific revision of this object (as opposed to the latest version, the default).",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation matches the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifGenerationNotMatch": {
-                            "description": "Makes the operation conditional on whether the object's current generation does not match the given value.",
+                            "description": "Makes the operation conditional on whether the 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.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
                         "ifMetagenerationMatch": {
                             "description": "Makes the operation conditional on whether the object's current metageneration matches the given value.",
                             "format": "int64",
                             "location": "query",
                             "type": "string"
                         },
@@ skipping 140 matching lines @@
                     ],
                     "supportsSubscription": true
                 }
             }
         },
         "projects": {
             "resources": {
                 "serviceAccount": {
                     "methods": {
                         "get": {
-                            "description": "Get the email address of this project's GCS service account.",
+                            "description": "Get the email address of this project's Google Cloud Storage service account.",
                             "httpMethod": "GET",
                             "id": "storage.projects.serviceAccount.get",
                             "parameterOrder": [
                                 "projectId"
                             ],
                             "parameters": {
                                 "projectId": {
                                     "description": "Project ID",
                                     "location": "path",
                                     "required": true,
@@ skipping 10 matching lines @@
                                 "https://www.googleapis.com/auth/devstorage.full_control",
                                 "https://www.googleapis.com/auth/devstorage.read_only",
                                 "https://www.googleapis.com/auth/devstorage.read_write"
                             ]
                         }
                     }
                 }
             }
         }
     },
-    "revision": "20170607",
+    "revision": "20170810",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Bucket": {
             "description": "A bucket.",
             "id": "Bucket",
             "properties": {
                 "acl": {
                     "annotations": {
                         "required": [
                             "storage.buckets.update"
@@ skipping 576 matching lines @@
                 },
                 "contentEncoding": {
                     "description": "Content-Encoding of the object data.",
                     "type": "string"
                 },
                 "contentLanguage": {
                     "description": "Content-Language of the object data.",
                     "type": "string"
                 },
                 "contentType": {
-                    "description": "Content-Type of the object data. If contentType is not specified, object downloads will be served as application/octet-stream.",
+                    "description": "Content-Type of the object data. If an object is stored without a Content-Type, it is served as application/octet-stream.",
                     "type": "string"
                 },
                 "crc32c": {
                     "description": "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.",
                     "type": "string"
                 },
                 "customerEncryption": {
                     "description": "Metadata of customer-supplied encryption key, if the object is encrypted by such a key.",
                     "properties": {
                         "encryptionAlgorithm": {
@@ skipping 282 matching lines @@
                     "description": "HTTP 1.1  Entity tag for the policy.",
                     "format": "byte",
                     "type": "string"
                 },
                 "kind": {
                     "default": "storage#policy",
                     "description": "The kind of item this is. For policies, this is always storage#policy. This field is ignored on input.",
                     "type": "string"
                 },
                 "resourceId": {
-                    "description": "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.",
+                    "description": "The ID of the resource to which this policy belongs. Will be of the form 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.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "RewriteResponse": {
             "description": "A rewrite response.",
             "id": "RewriteResponse",
             "properties": {
                 "done": {
@@ skipping 59 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "storage/v1/",
     "title": "Cloud Storage JSON API",
     "version": "v1"
 }