Api-roll 42: 2016-11-08

discovery/googleapis_beta/pubsub__v1beta2.json

Index: discovery/googleapis_beta/pubsub__v1beta2.json
diff --git a/discovery/googleapis_beta/pubsub__v1beta2.json b/discovery/googleapis_beta/pubsub__v1beta2.json
index 6ed1846b2dc2e04dc54a706b74c5e318b672a500..e97e37bdfb7d3ad95db92305c5439631f06d3cbd 100644
--- a/discovery/googleapis_beta/pubsub__v1beta2.json
+++ b/discovery/googleapis_beta/pubsub__v1beta2.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/bCHPJ2BvROiKtNiRgnXJErIP0lU\"",
+    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/0vA2xGfn2MUMrRKKZWbff76Y_7U\"",
     "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": [
@@ -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": [
@@ -693,7 +693,7 @@
             }
         }
     },
-    "revision": "20160317",
+    "revision": "20161003",
     "rootUrl": "https://pubsub.googleapis.com/",
     "schemas": {
         "SetIamPolicyRequest": {
@@ -754,7 +754,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 +807,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 +901,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"
                 }