service.rb in google-api-client-0.12.0

- old
+ new

@@ -157,23 +157,23 @@
           command.query['fields'] = fields unless fields.nil?
           execute_or_queue_command(command, &block)
         end
         
         # Lists transfer jobs.
+        # @param [String] page_token
+        #   The list page token.
+        # @param [Fixnum] page_size
+        #   The list page size. The max allowed value is 256.
         # @param [String] filter
         #   A list of query parameters specified as JSON text in the form of
         #   `"project_id":"my_project_id",
         #   "job_names":["jobid1","jobid2",...],
         #   "job_statuses":["status1","status2",...]`.
         #   Since `job_names` and `job_statuses` support multiple values, their values
         #   must be specified with array notation. `project_id` is required. `job_names`
         #   and `job_statuses` are optional.  The valid values for `job_statuses` are
         #   case-insensitive: `ENABLED`, `DISABLED`, and `DELETED`.
-        # @param [String] page_token
-        #   The list page token.
-        # @param [Fixnum] page_size
-        #   The list page size. The max allowed value is 256.
         # @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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -187,17 +187,17 @@
         # @return [Google::Apis::StoragetransferV1::ListTransferJobsResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_transfer_jobs(filter: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
+        def list_transfer_jobs(page_token: nil, page_size: nil, filter: nil, quota_user: nil, fields: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/transferJobs', options)
           command.response_representation = Google::Apis::StoragetransferV1::ListTransferJobsResponse::Representation
           command.response_class = Google::Apis::StoragetransferV1::ListTransferJobsResponse
-          command.query['filter'] = filter unless filter.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['filter'] = filter unless filter.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['fields'] = fields unless fields.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -229,10 +229,44 @@
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['fields'] = fields unless fields.nil?
           execute_or_queue_command(command, &block)
         end
         
+        # Pauses a transfer operation.
+        # @param [String] name
+        #   The name of the transfer operation.
+        #   Required.
+        # @param [Google::Apis::StoragetransferV1::PauseTransferOperationRequest] pause_transfer_operation_request_object
+        # @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.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::StoragetransferV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StoragetransferV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def pause_transfer_operation(name, pause_transfer_operation_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:pause', options)
+          command.request_representation = Google::Apis::StoragetransferV1::PauseTransferOperationRequest::Representation
+          command.request_object = pause_transfer_operation_request_object
+          command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
+          command.response_class = Google::Apis::StoragetransferV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['fields'] = fields unless fields.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # This method is not supported and the server returns `UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] quota_user
         #   Available to use for quota purposes for server-side applications. Can be any
@@ -261,25 +295,30 @@
           execute_or_queue_command(command, &block)
         end
         
         # Lists operations that match the specified filter in the request. If the
         # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding below allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`.
+        # NOTE: the `name` binding allows API services to override the binding
+        # to use different resource name schemes, such as `users/*/operations`. To
+        # override the binding, API services can add a binding such as
+        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # For backwards compatibility, the default name includes the operations
+        # collection id, however overriding users must ensure the name binding
+        # is the parent resource, without the operations collection id.
         # @param [String] name
         #   The value `transferOperations`.
+        # @param [String] page_token
+        #   The list page token.
+        # @param [Fixnum] page_size
+        #   The list page size. The max allowed value is 256.
         # @param [String] filter
         #   A list of query parameters specified as JSON text in the form of `\"project_id\
         #   " : \"my_project_id\", \"job_names\" : [\"jobid1\", \"jobid2\",...], \"
         #   operation_names\" : [\"opid1\", \"opid2\",...], \"transfer_statuses\":[\"
         #   status1\", \"status2\",...]`. Since `job_names`, `operation_names`, and `
         #   transfer_statuses` support multiple values, they must be specified with array
         #   notation. `job_names`, `operation_names`, and `transfer_statuses` are optional.
-        # @param [String] page_token
-        #   The list page token.
-        # @param [Fixnum] page_size
-        #   The list page size. The max allowed value is 256.
         # @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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -293,18 +332,18 @@
         # @return [Google::Apis::StoragetransferV1::ListOperationsResponse]
         #
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_transfer_operations(name, filter: nil, page_token: nil, page_size: nil, quota_user: nil, fields: nil, options: nil, &block)
+        def list_transfer_operations(name, page_token: nil, page_size: nil, filter: nil, quota_user: nil, fields: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::StoragetransferV1::ListOperationsResponse::Representation
           command.response_class = Google::Apis::StoragetransferV1::ListOperationsResponse
           command.params['name'] = name unless name.nil?
-          command.query['filter'] = filter unless filter.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['filter'] = filter unless filter.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['fields'] = fields unless fields.nil?
           execute_or_queue_command(command, &block)
         end
         
@@ -397,43 +436,9 @@
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def get_transfer_operation(name, quota_user: nil, fields: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/{+name}', options)
           command.response_representation = Google::Apis::StoragetransferV1::Operation::Representation
           command.response_class = Google::Apis::StoragetransferV1::Operation
-          command.params['name'] = name unless name.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['fields'] = fields unless fields.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Pauses a transfer operation.
-        # @param [String] name
-        #   The name of the transfer operation.
-        #   Required.
-        # @param [Google::Apis::StoragetransferV1::PauseTransferOperationRequest] pause_transfer_operation_request_object
-        # @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.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::StoragetransferV1::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::StoragetransferV1::Empty]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def pause_transfer_operation(name, pause_transfer_operation_request_object = nil, quota_user: nil, fields: nil, options: nil, &block)
-          command =  make_simple_command(:post, 'v1/{+name}:pause', options)
-          command.request_representation = Google::Apis::StoragetransferV1::PauseTransferOperationRequest::Representation
-          command.request_object = pause_transfer_operation_request_object
-          command.response_representation = Google::Apis::StoragetransferV1::Empty::Representation
-          command.response_class = Google::Apis::StoragetransferV1::Empty
           command.params['name'] = name unless name.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['fields'] = fields unless fields.nil?
           execute_or_queue_command(command, &block)
         end