Api-roll 42: 2016-11-08

discovery/googleapis/pubsub__v1.json

Index: discovery/googleapis/pubsub__v1.json
diff --git a/discovery/googleapis/pubsub__v1.json b/discovery/googleapis/pubsub__v1.json
index 27ceb618d74c9175c04d8a6f0ee492901ffa7ebd..d05cf2b900f4f2be37d1c2e3fbcdb767a92301fe 100644
--- a/discovery/googleapis/pubsub__v1.json
+++ b/discovery/googleapis/pubsub__v1.json
@@ -17,7 +17,7 @@
     "description": "Provides reliable, many-to-many, asynchronous messaging between applications.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/pubsub/docs",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/liyzgLngirW3xU7Tt2Pd1AnSK1c\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/HIsdIvCDXEirzqtPtZbE0wV3MKA\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
@@ -121,7 +121,7 @@
                             ],
                             "parameters": {
                                 "resource": {
-                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `setIamPolicy` documentation.",
+                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]*/topics/[^/]*$",
                                     "required": true,
@@ -141,7 +141,7 @@
                             ]
                         },
                         "getIamPolicy": {
-                            "description": "Gets the access control policy for a `resource`. Returns an empty policy if the resource exists and does not have a policy set.",
+                            "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.",
                             "httpMethod": "GET",
                             "id": "pubsub.projects.topics.getIamPolicy",
                             "parameterOrder": [
@@ -149,7 +149,7 @@
                             ],
                             "parameters": {
                                 "resource": {
-                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `getIamPolicy` documentation.",
+                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]*/topics/[^/]*$",
                                     "required": true,
@@ -174,7 +174,7 @@
                             ],
                             "parameters": {
                                 "resource": {
-                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `testIamPermissions` documentation.",
+                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]*/topics/[^/]*$",
                                     "required": true,
@@ -390,7 +390,7 @@
                             ],
                             "parameters": {
                                 "resource": {
-                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `setIamPolicy` documentation.",
+                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]*/subscriptions/[^/]*$",
                                     "required": true,
@@ -410,7 +410,7 @@
                             ]
                         },
                         "getIamPolicy": {
-                            "description": "Gets the access control policy for a `resource`. Returns an empty policy if the resource exists and does not have a policy set.",
+                            "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.",
                             "httpMethod": "GET",
                             "id": "pubsub.projects.subscriptions.getIamPolicy",
                             "parameterOrder": [
@@ -418,7 +418,7 @@
                             ],
                             "parameters": {
                                 "resource": {
-                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `getIamPolicy` documentation.",
+                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]*/subscriptions/[^/]*$",
                                     "required": true,
@@ -443,7 +443,7 @@
                             ],
                             "parameters": {
                                 "resource": {
-                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*disk*`. The format for the path specified in this value is resource specific and is specified in the `testIamPermissions` documentation.",
+                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
                                     "location": "path",
                                     "pattern": "^projects/[^/]*/subscriptions/[^/]*$",
                                     "required": true,
@@ -463,7 +463,7 @@
                             ]
                         },
                         "create": {
-                            "description": "Creates a subscription to a given topic. If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic.",
+                            "description": "Creates a subscription to a given topic. If the subscription already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't exist, returns `NOT_FOUND`. If the name is not provided in the request, the server will assign a random name for this subscription on the same project as the topic. Note that for REST API requests, you must specify a name.",
                             "httpMethod": "PUT",
                             "id": "pubsub.projects.subscriptions.create",
                             "parameterOrder": [
@@ -552,7 +552,7 @@
                             ]
                         },
                         "delete": {
-                            "description": "Deletes an existing subscription. All pending messages in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription, or its topic unless the same topic is specified.",
+                            "description": "Deletes an existing subscription. All messages retained in the subscription are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`. After a subscription is deleted, a new one may be created with the same name, but the new one has no association with the old subscription or its topic unless the same topic is specified.",
                             "httpMethod": "DELETE",
                             "id": "pubsub.projects.subscriptions.delete",
                             "parameterOrder": [
@@ -577,7 +577,7 @@
                             ]
                         },
                         "modifyAckDeadline": {
-                            "description": "Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted.",
+                            "description": "Modifies the ack deadline for a specific message. This method is useful to indicate that more time is needed to process a message by the subscriber, or to make the message available for redelivery if the processing was interrupted. Note that this does not modify the subscription-level `ackDeadlineSeconds` used for subsequent messages.",
                             "httpMethod": "POST",
                             "id": "pubsub.projects.subscriptions.modifyAckDeadline",
                             "parameterOrder": [
@@ -689,11 +689,96 @@
                             ]
                         }
                     }
+                },
+                "snapshots": {
+                    "methods": {
+                        "setIamPolicy": {
+                            "description": "Sets the access control policy on the specified resource. Replaces any existing policy.",
+                            "httpMethod": "POST",
+                            "id": "pubsub.projects.snapshots.setIamPolicy",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy is being specified. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/snapshots/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/{+resource}:setIamPolicy",
+                            "request": {
+                                "$ref": "SetIamPolicyRequest"
+                            },
+                            "response": {
+                                "$ref": "Policy"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/pubsub"
+                            ]
+                        },
+                        "getIamPolicy": {
+                            "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.",
+                            "httpMethod": "GET",
+                            "id": "pubsub.projects.snapshots.getIamPolicy",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/snapshots/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/{+resource}:getIamPolicy",
+                            "response": {
+                                "$ref": "Policy"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/pubsub"
+                            ]
+                        },
+                        "testIamPermissions": {
+                            "description": "Returns permissions that a caller has on the specified resource.",
+                            "httpMethod": "POST",
+                            "id": "pubsub.projects.snapshots.testIamPermissions",
+                            "parameterOrder": [
+                                "resource"
+                            ],
+                            "parameters": {
+                                "resource": {
+                                    "description": "REQUIRED: The resource for which the policy detail is being requested. `resource` is usually specified as a path. For example, a Project resource is specified as `projects/{project}`.",
+                                    "location": "path",
+                                    "pattern": "^projects/[^/]*/snapshots/[^/]*$",
+                                    "required": true,
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/{+resource}:testIamPermissions",
+                            "request": {
+                                "$ref": "TestIamPermissionsRequest"
+                            },
+                            "response": {
+                                "$ref": "TestIamPermissionsResponse"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/cloud-platform",
+                                "https://www.googleapis.com/auth/pubsub"
+                            ]
+                        }
+                    }
                 }
             }
         }
     },
-    "revision": "20160317",
+    "revision": "20161003",
     "rootUrl": "https://pubsub.googleapis.com/",
     "schemas": {
         "SetIamPolicyRequest": {
@@ -754,7 +839,7 @@
             "id": "TestIamPermissionsRequest",
             "properties": {
                 "permissions": {
-                    "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see IAM Overview.",
+                    "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).",
                     "items": {
                         "type": "string"
                     },
@@ -807,7 +892,7 @@
             "id": "PubsubMessage",
             "properties": {
                 "data": {
-                    "description": "The message payload. For JSON requests, the value of this field must be base64-encoded.",
+                    "description": "The message payload. For JSON requests, the value of this field must be [base64-encoded](https://tools.ietf.org/html/rfc4648).",
                     "format": "byte",
                     "type": "string"
                 },
@@ -901,7 +986,7 @@
                     "description": "If push delivery is used with this subscription, this field is used to configure it. An empty `pushConfig` signifies that the subscriber will pull and ack messages using API methods."
                 },
                 "ackDeadlineSeconds": {
-                    "description": "This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is not set, the default value of 10 seconds is used.",
+                    "description": "This value is the maximum time after a subscriber receives a message before the subscriber should acknowledge the message. After message delivery but before the ack deadline expires and before the message is acknowledged, it is an outstanding message and will not be delivered again during that time (on a best-effort basis). For pull subscriptions, this value is used as the initial value for the ack deadline. To override this value for a given message, call `ModifyAckDeadline` with the corresponding `ack_id` if using pull. The maximum custom deadline you can specify is 600 seconds (10 minutes). For push delivery, this value is also used to set the request timeout for the call to the push endpoint. If the subscriber never acknowledges the message, the Pub/Sub system will eventually redeliver the message. If this parameter is 0, a default value of 10 seconds is used.",
                     "format": "int32",
                     "type": "integer"
                 }