Api-roll 47: 2017-03-27

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": "\"tbys6C40o18GZwyMen5GMkdK-3s/87TjkqlQLQJ6FjZ3rw1XvgyEGys\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/8cCymGQcL21bwNs4pLrUlHm7CoQ\"",
     "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 309 matching lines @@
                         "$ref": "Bucket"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_only",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ]
                 },
+                "getIamPolicy": {
+                    "description": "Returns an IAM policy for the specified bucket.",
+                    "httpMethod": "GET",
+                    "id": "storage.buckets.getIamPolicy",
+                    "parameterOrder": [
+                        "bucket"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "Name of a bucket.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/iam",
+                    "response": {
+                        "$ref": "Policy"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_only",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
                 "insert": {
                     "description": "Creates a new bucket.",
                     "httpMethod": "POST",
                     "id": "storage.buckets.insert",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "predefinedAcl": {
                             "description": "Apply a predefined set of access controls to this bucket.",
@@ skipping 211 matching lines @@
                         "$ref": "Bucket"
                     },
                     "response": {
                         "$ref": "Bucket"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/devstorage.full_control"
                     ]
                 },
+                "setIamPolicy": {
+                    "description": "Updates an IAM policy for the specified bucket.",
+                    "httpMethod": "PUT",
+                    "id": "storage.buckets.setIamPolicy",
+                    "parameterOrder": [
+                        "bucket"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "Name of a bucket.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/iam",
+                    "request": {
+                        "$ref": "Policy"
+                    },
+                    "response": {
+                        "$ref": "Policy"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
+                "testIamPermissions": {
+                    "description": "Tests a set of permissions on the given bucket to see which, if any, are held by the caller.",
+                    "httpMethod": "GET",
+                    "id": "storage.buckets.testIamPermissions",
+                    "parameterOrder": [
+                        "bucket",
+                        "permissions"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "Name of a bucket.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "permissions": {
+                            "description": "Permissions to test.",
+                            "location": "query",
+                            "repeated": true,
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/iam/testPermissions",
+                    "response": {
+                        "$ref": "TestIamPermissionsResponse"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_only",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
                 "update": {
                     "description": "Updates a bucket. Changes to the bucket will be readable immediately after writing, but configuration changes may take time to propagate.",
                     "httpMethod": "PUT",
                     "id": "storage.buckets.update",
                     "parameterOrder": [
                         "bucket"
                     ],
                     "parameters": {
                         "bucket": {
                             "description": "Name of a bucket.",
@@ skipping 895 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_only",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ],
                     "supportsMediaDownload": true
                 },
+                "getIamPolicy": {
+                    "description": "Returns an IAM policy for the specified object.",
+                    "httpMethod": "GET",
+                    "id": "storage.objects.getIamPolicy",
+                    "parameterOrder": [
+                        "bucket",
+                        "object"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "Name of the bucket in which the object resides.",
+                            "location": "path",
+                            "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"
+                        },
+                        "object": {
+                            "description": "Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/o/{object}/iam",
+                    "response": {
+                        "$ref": "Policy"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_only",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
                 "insert": {
                     "description": "Stores a new object and metadata.",
                     "httpMethod": "POST",
                     "id": "storage.objects.insert",
                     "mediaUpload": {
                         "accept": [
                             "*/*"
                         ],
                         "protocols": {
                             "resumable": {
@@ skipping 408 matching lines @@
                     },
                     "response": {
                         "$ref": "RewriteResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ]
                 },
+                "setIamPolicy": {
+                    "description": "Updates an IAM policy for the specified object.",
+                    "httpMethod": "PUT",
+                    "id": "storage.objects.setIamPolicy",
+                    "parameterOrder": [
+                        "bucket",
+                        "object"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "Name of the bucket in which the object resides.",
+                            "location": "path",
+                            "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"
+                        },
+                        "object": {
+                            "description": "Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/o/{object}/iam",
+                    "request": {
+                        "$ref": "Policy"
+                    },
+                    "response": {
+                        "$ref": "Policy"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
+                "testIamPermissions": {
+                    "description": "Tests a set of permissions on the given object to see which, if any, are held by the caller.",
+                    "httpMethod": "GET",
+                    "id": "storage.objects.testIamPermissions",
+                    "parameterOrder": [
+                        "bucket",
+                        "object",
+                        "permissions"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "Name of the bucket in which the object resides.",
+                            "location": "path",
+                            "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"
+                        },
+                        "object": {
+                            "description": "Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "permissions": {
+                            "description": "Permissions to test.",
+                            "location": "query",
+                            "repeated": true,
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/o/{object}/iam/testPermissions",
+                    "response": {
+                        "$ref": "TestIamPermissionsResponse"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/cloud-platform.read-only",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_only",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
                 "update": {
                     "description": "Updates an object's metadata.",
                     "httpMethod": "PUT",
                     "id": "storage.objects.update",
                     "parameterOrder": [
                         "bucket",
                         "object"
                     ],
                     "parameters": {
                         "bucket": {
@@ skipping 155 matching lines @@
                         "https://www.googleapis.com/auth/cloud-platform.read-only",
                         "https://www.googleapis.com/auth/devstorage.full_control",
                         "https://www.googleapis.com/auth/devstorage.read_only",
                         "https://www.googleapis.com/auth/devstorage.read_write"
                     ],
                     "supportsSubscription": true
                 }
             }
         }
     },
-    "revision": "20170224",
+    "revision": "20170308",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Bucket": {
             "description": "A bucket.",
             "id": "Bucket",
             "properties": {
                 "acl": {
                     "annotations": {
                         "required": [
                             "storage.buckets.update"
@@ skipping 720 matching lines @@
                 "prefixes": {
                     "description": "The list of prefixes of objects matching-but-not-listed up to and including the requested delimiter.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "Policy": {
+            "description": "A bucket/object IAM policy.",
+            "id": "Policy",
+            "properties": {
+                "bindings": {
+                    "annotations": {
+                        "required": [
+                            "storage.buckets.setIamPolicy",
+                            "storage.objects.setIamPolicy"
+                        ]
+                    },
+                    "description": "An association between a role, which comes with a set of permissions, and members who may assume that role.",
+                    "items": {
+                        "properties": {
+                            "members": {
+                                "annotations": {
+                                    "required": [
+                                        "storage.buckets.setIamPolicy",
+                                        "storage.objects.setIamPolicy"
+                                    ]
+                                },
+                                "description": "A collection of identifiers for members who may assume the provided role. Recognized identifiers are as follows:  \n- allUsers — A special identifier that represents anyone on the internet; with or without a Google account.  \n- allAuthenticatedUsers — A special identifier that represents anyone who is authenticated with a Google account or a service account.  \n- user:emailid — An email address that represents a specific account. For example, user:alice@gmail.com or user:joe@example.com.  \n- serviceAccount:emailid — An email address that represents a service account. For example,  serviceAccount:my-other-app@appspot.gserviceaccount.com .  \n- group:emailid — An email address that represents a Google group. For example, group:admins@example.com.  \n- domain:domain — A Google Apps domain name that represents all the users of that domain. For example, domain:google.com or domain:example.com.  \n- projectOwner:projectid — Owners of the given project. For example, projectOwner:my-example-project  \n- projectEditor:projectid — Editors of the given project. For example, projectEditor:my-example-project  \n- projectViewer:projectid — Viewers of the given project. For example, projectViewer:my-example-project",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "type": "array"
+                            },
+                            "role": {
+                                "annotations": {
+                                    "required": [
+                                        "storage.buckets.setIamPolicy",
+                                        "storage.objects.setIamPolicy"
+                                    ]
+                                },
+                                "description": "The role to which members belong. Two types of roles are supported: new IAM roles, which grant permissions that do not map directly to those provided by ACLs, and legacy IAM roles, which do map directly to ACL permissions. All roles are of the format roles/storage.specificRole.\nThe new IAM roles are:  \n- roles/storage.admin — Full control of Google Cloud Storage resources.  \n- roles/storage.objectViewer — Read-Only access to Google Cloud Storage objects.  \n- roles/storage.objectCreator — Access to create objects in Google Cloud Storage.  \n- roles/storage.objectAdmin — Full control of Google Cloud Storage objects.   The legacy IAM roles are:  \n- roles/storage.legacyObjectReader — Read-only access to objects without listing. Equivalent to an ACL entry on an object with the READER role.  \n- roles/storage.legacyObjectOwner — Read/write access to existing objects without listing. Equivalent to an ACL entry on an object with the OWNER role.  \n- roles/storage.legacyBucketReader — Read access to buckets with object listing. Equivalent to an ACL entry on a bucket with the READER role.  \n- roles/storage.legacyBucketWriter — Read access to buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the WRITER role.  \n- roles/storage.legacyBucketOwner — Read and write access to existing buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the OWNER role.",
+                                "type": "string"
+                            }
+                        },
+                        "type": "object"
+                    },
+                    "type": "array"
+                },
+                "etag": {
+                    "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.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "RewriteResponse": {
             "description": "A rewrite response.",
             "id": "RewriteResponse",
             "properties": {
                 "done": {
                     "description": "true if the copy is finished; otherwise, false if the copy is in progress. This property is always present in the response.",
                     "type": "boolean"
                 },
                 "kind": {
                     "default": "storage#rewriteResponse",
@@ skipping 13 matching lines @@
                     "description": "A token to use in subsequent requests to continue copying data. This token is present in the response only when there is more data to copy.",
                     "type": "string"
                 },
                 "totalBytesRewritten": {
                     "description": "The total bytes written so far, which can be used to provide a waiting user with a progress indicator. This property is always present in the response.",
                     "format": "uint64",
                     "type": "string"
                 }
             },
             "type": "object"
+        },
+        "TestIamPermissionsResponse": {
+            "description": "A storage.(buckets|objects).testIamPermissions response.",
+            "id": "TestIamPermissionsResponse",
+            "properties": {
+                "kind": {
+                    "default": "storage#testIamPermissionsResponse",
+                    "description": "The kind of item this is.",
+                    "type": "string"
+                },
+                "permissions": {
+                    "description": "The permissions held by the caller. Permissions are always of the format storage.resource.capability, where resource is one of buckets or objects. The supported permissions are as follows:  \n- storage.buckets.delete — Delete bucket.  \n- storage.buckets.get — Read bucket metadata.  \n- storage.buckets.getIamPolicy — Read bucket IAM policy.  \n- storage.buckets.create — Create bucket.  \n- storage.buckets.list — List buckets.  \n- storage.buckets.setIamPolicy — Update bucket IAM policy.  \n- storage.buckets.update — Update bucket metadata.  \n- storage.objects.delete — Delete object.  \n- storage.objects.get — Read object data and metadata.  \n- storage.objects.getIamPolicy — Read object IAM policy.  \n- storage.objects.create — Create object.  \n- storage.objects.list — List objects.  \n- storage.objects.setIamPolicy — Update object IAM policy.  \n- storage.objects.update — Update object metadata.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
         }
     },
     "servicePath": "storage/v1/",
     "title": "Cloud Storage JSON API",
     "version": "v1"
 }