Api-roll 48: 2017-04-18

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/8cCymGQcL21bwNs4pLrUlHm7CoQ\"",
+    "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/9bnQR_kC7lWpyFxyRiXZLFFekco\"",
     "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 939 matching lines @@
                     "response": {
                         "$ref": "ObjectAccessControl"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/devstorage.full_control"
                     ]
                 }
             }
         },
+        "notifications": {
+            "methods": {
+                "delete": {
+                    "description": "Permanently deletes a notification subscription.",
+                    "httpMethod": "DELETE",
+                    "id": "storage.notifications.delete",
+                    "parameterOrder": [
+                        "bucket",
+                        "notification"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "The parent bucket of the notification.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "notification": {
+                            "description": "ID of the notification to delete.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/notificationConfigs/{notification}",
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
+                "get": {
+                    "description": "View a notification configuration.",
+                    "httpMethod": "GET",
+                    "id": "storage.notifications.get",
+                    "parameterOrder": [
+                        "bucket",
+                        "notification"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "The parent bucket of the notification.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "notification": {
+                            "description": "Notification ID",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/notificationConfigs/{notification}",
+                    "response": {
+                        "$ref": "Notification"
+                    },
+                    "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 notification subscription for a given bucket.",
+                    "httpMethod": "POST",
+                    "id": "storage.notifications.insert",
+                    "parameterOrder": [
+                        "bucket"
+                    ],
+                    "parameters": {
+                        "bucket": {
+                            "description": "The parent bucket of the notification.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/notificationConfigs",
+                    "request": {
+                        "$ref": "Notification"
+                    },
+                    "response": {
+                        "$ref": "Notification"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/devstorage.full_control",
+                        "https://www.googleapis.com/auth/devstorage.read_write"
+                    ]
+                },
+                "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.",
+                            "location": "path",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "b/{bucket}/notificationConfigs",
+                    "response": {
+                        "$ref": "Notifications"
+                    },
+                    "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"
+                    ]
+                }
+            }
+        },
         "objectAccessControls": {
             "methods": {
                 "delete": {
                     "description": "Permanently deletes the ACL entry for the specified entity on the specified object.",
                     "httpMethod": "DELETE",
                     "id": "storage.objectAccessControls.delete",
                     "parameterOrder": [
                         "bucket",
                         "object",
                         "entity"
@@ skipping 1316 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"
                     ],
                     "supportsSubscription": true
                 }
             }
+        },
+        "projects": {
+            "resources": {
+                "serviceAccount": {
+                    "methods": {
+                        "get": {
+                            "description": "Get the email address of this project's GCS service account.",
+                            "httpMethod": "GET",
+                            "id": "storage.projects.serviceAccount.get",
+                            "parameterOrder": [
+                                "projectId"
+                            ],
+                            "parameters": {
+                                "projectId": {
+                                    "description": "Project ID",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "projects/{projectId}/serviceAccount",
+                            "response": {
+                                "$ref": "ServiceAccount"
+                            },
+                            "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"
+                            ]
+                        }
+                    }
+                }
+            }
         }
     },
-    "revision": "20170308",
+    "revision": "20170329",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Bucket": {
             "description": "A bucket.",
             "id": "Bucket",
             "properties": {
                 "acl": {
                     "annotations": {
                         "required": [
                             "storage.buckets.update"
@@ skipping 53 matching lines @@
                 },
                 "id": {
                     "description": "The ID of the bucket. For buckets, the id and name properities are the same.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "storage#bucket",
                     "description": "The kind of item this is. For buckets, this is always storage#bucket.",
                     "type": "string"
                 },
+                "labels": {
+                    "additionalProperties": {
+                        "description": "An individual label entry.",
+                        "type": "string"
+                    },
+                    "description": "User-provided labels, in key/value pairs.",
+                    "type": "object"
+                },
                 "lifecycle": {
                     "description": "The bucket's lifecycle configuration. See lifecycle management for more information.",
                     "properties": {
                         "rule": {
                             "description": "A lifecycle management rule, which is made of an action to take and the condition(s) under which the action will be taken.",
                             "items": {
                                 "properties": {
                                     "action": {
                                         "description": "The action to take.",
                                         "properties": {
@@ skipping 359 matching lines @@
                                 "type": "object"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
+        "Notification": {
+            "description": "A subscription to receive Google PubSub notifications.",
+            "id": "Notification",
+            "properties": {
+                "custom_attributes": {
+                    "additionalProperties": {
+                        "type": "string"
+                    },
+                    "description": "An optional list of additional attributes to attach to each Cloud PubSub message published for this notification subscription.",
+                    "type": "object"
+                },
+                "etag": {
+                    "description": "HTTP 1.1 Entity tag for this subscription notification.",
+                    "type": "string"
+                },
+                "event_types": {
+                    "description": "If present, only send notifications about listed event types. If empty, sent notifications for all event types.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "id": {
+                    "description": "The ID of the notification.",
+                    "type": "string"
+                },
+                "kind": {
+                    "default": "storage#notification",
+                    "description": "The kind of item this is. For notifications, this is always storage#notification.",
+                    "type": "string"
+                },
+                "object_name_prefix": {
+                    "description": "If present, only apply this notification configuration to object names that begin with this prefix.",
+                    "type": "string"
+                },
+                "payload_format": {
+                    "default": "JSON_API_V1",
+                    "description": "The desired content of the Payload.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "The canonical URL of this notification.",
+                    "type": "string"
+                },
+                "topic": {
+                    "annotations": {
+                        "required": [
+                            "storage.notifications.insert"
+                        ]
+                    },
+                    "description": "The Cloud PubSub topic to which this subscription publishes. Formatted as: '//pubsub.googleapis.com/projects/{project-identifier}/topics/{my-topic}'",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "Notifications": {
+            "description": "A list of notification subscriptions.",
+            "id": "Notifications",
+            "properties": {
+                "items": {
+                    "description": "The list of items.",
+                    "items": {
+                        "$ref": "Notification"
+                    },
+                    "type": "array"
+                },
+                "kind": {
+                    "default": "storage#notifications",
+                    "description": "The kind of item this is. For lists of notifications, this is always storage#notifications.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "Object": {
             "description": "An object.",
             "id": "Object",
             "properties": {
                 "acl": {
                     "annotations": {
                         "required": [
                             "storage.objects.update"
                         ]
                     },
@@ skipping 361 matching lines @@
                     "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"
         },
+        "ServiceAccount": {
+            "description": "A subscription to receive Google PubSub notifications.",
+            "id": "ServiceAccount",
+            "properties": {
+                "email_address": {
+                    "description": "The ID of the notification.",
+                    "type": "string"
+                },
+                "kind": {
+                    "default": "storage#serviceAccount",
+                    "description": "The kind of item this is. For notifications, this is always storage#notification.",
+                    "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"
 }