service.rb in google-api-client-0.9.pre2

- old
+ new

@@ -47,12 +47,13 @@
         end
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
         # @param [String] resource
-        #   REQUIRED: The resource for which policy is being specified. Usually some path
-        #   like projects/`project`/zones/`zone`/disks/`disk`.
+        #   REQUIRED: The resource for which policy is being specified. Resource is
+        #   usually specified as a path, such as, projects/`project`/zones/`zone`/disks/`
+        #   disk`.
         # @param [Google::Apis::PubsubV1beta2::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -80,15 +81,15 @@
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource. May be empty if no such policy
-        # or resource exists.
+        # Gets the access control policy for a resource. Is empty if the policy or the
+        # resource does not exist.
         # @param [String] resource
-        #   REQUIRED: The resource for which policy is being requested. Usually some path
-        #   like projects/`project`.
+        #   REQUIRED: The resource for which policy is being requested. Resource is
+        #   usually specified as a path, such as, projects/`project`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
         #   arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -115,12 +116,12 @@
           execute_or_queue_command(command, &block)
         end
         
         # Returns permissions that a caller has on the specified resource.
         # @param [String] resource
-        #   REQUIRED: The resource for which policy detail is being requested. Usually
-        #   some path like projects/`project`.
+        #   REQUIRED: The resource for which policy detail is being requested. Resource is
+        #   usually specified as a path, such as, projects/`project`.
         # @param [Google::Apis::PubsubV1beta2::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -151,14 +152,15 @@
         end
         
         # Creates the given topic with the given name.
         # @param [String] name
         #   The name of the topic. It must have the format "projects/`project`/topics/`
-        #   topic`" for Google Cloud Pub/Sub API v1beta2. `topic` must start with a letter,
-        #   and contain only letters ([A-Za-z]), numbers ([0-9], dashes (-), underscores (
-        #   _), periods (.), tildes (~), plus (+) or percent signs (%). It must be between
-        #   3 and 255 characters in length, and it must not start with "goog".
+        #   topic`" for Google Cloud Pub/Sub API v1 and v1beta2. `topic` must start with a
+        #   letter, and contain only letters ([A-Za-z]), numbers ([0-9], dashes (-),
+        #   underscores (_), periods (.), tildes (~), plus (+) or percent signs (%). It
+        #   must be between 3 and 255 characters in length, and it must not start with "
+        #   goog".
         # @param [Google::Apis::PubsubV1beta2::Topic] topic_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -294,11 +296,12 @@
         end
         
         # Deletes the topic with the given name. Returns NOT_FOUND if the topic does not
         # exist. After a topic is deleted, a new topic may be created with the same name;
         # this is an entirely new topic with none of the old configuration or
-        # subscriptions. Existing subscriptions to this topic are not deleted.
+        # subscriptions. Existing subscriptions to this topic are not deleted, but their
+        # `topic` field is set to `_deleted-topic_`.
         # @param [String] topic
         #   Name of the topic to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -367,12 +370,13 @@
         end
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
         # @param [String] resource
-        #   REQUIRED: The resource for which policy is being specified. Usually some path
-        #   like projects/`project`/zones/`zone`/disks/`disk`.
+        #   REQUIRED: The resource for which policy is being specified. Resource is
+        #   usually specified as a path, such as, projects/`project`/zones/`zone`/disks/`
+        #   disk`.
         # @param [Google::Apis::PubsubV1beta2::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -400,15 +404,15 @@
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource. May be empty if no such policy
-        # or resource exists.
+        # Gets the access control policy for a resource. Is empty if the policy or the
+        # resource does not exist.
         # @param [String] resource
-        #   REQUIRED: The resource for which policy is being requested. Usually some path
-        #   like projects/`project`.
+        #   REQUIRED: The resource for which policy is being requested. Resource is
+        #   usually specified as a path, such as, projects/`project`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
         #   arbitrary string assigned to a user, but should not exceed 40 characters.
@@ -435,12 +439,12 @@
           execute_or_queue_command(command, &block)
         end
         
         # Returns permissions that a caller has on the specified resource.
         # @param [String] resource
-        #   REQUIRED: The resource for which policy detail is being requested. Usually
-        #   some path like projects/`project`.
+        #   REQUIRED: The resource for which policy detail is being requested. Resource is
+        #   usually specified as a path, such as, projects/`project`.
         # @param [Google::Apis::PubsubV1beta2::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -475,10 +479,10 @@
         # 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.
         # @param [String] name
         #   The name of the subscription. It must have the format "projects/`project`/
-        #   subscriptions/`subscription`" for Google Cloud Pub/Sub API v1beta2. `
+        #   subscriptions/`subscription`" for Google Cloud Pub/Sub API v1 and v1beta2. `
         #   subscription` must start with a letter, and contain only letters ([A-Za-z]),
         #   numbers ([0-9], dashes (-), underscores (_), periods (.), tildes (~), plus (+)
         #   or percent signs (%). It must be between 3 and 255 characters in length, and
         #   it must not start with "goog".
         # @param [Google::Apis::PubsubV1beta2::Subscription] subscription_object