google-api-client 0.17.3 → 0.17.4

data/generated/google/apis/pubsub_v1/service.rb

@@ -47,6 +47,89 @@ module Google
           @batch_path = 'batch'
         end
         
+        # Creates a snapshot from the requested subscription.
+        # If the snapshot already exists, returns `ALREADY_EXISTS`.
+        # If the requested subscription doesn't exist, returns `NOT_FOUND`.
+        # If the backlog in the subscription is too old -- and the resulting snapshot
+        # would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
+        # See also the `Snapshot.expire_time` field.
+        # If the name is not provided in the request, the server will assign a random
+        # name for this snapshot on the same project as the subscription, conforming
+        # to the
+        # [resource name
+        # format](https://cloud.google.com/pubsub/docs/overview#names). The generated
+        # name is populated in the returned Snapshot object. Note that for REST API
+        # requests, you must specify a name in the request.
+        # @param [String] name
+        #   Optional user-provided name for this snapshot.
+        #   If the name is not provided in the request, the server will assign a random
+        #   name for this snapshot on the same project as the subscription.
+        #   Note that for REST API requests, you must specify a name.
+        #   Format is `projects/`project`/snapshots/`snap``.
+        # @param [Google::Apis::PubsubV1::CreateSnapshotRequest] create_snapshot_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
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::Snapshot] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::Snapshot]
+        #
+        # @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 create_snapshot(name, create_snapshot_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::PubsubV1::CreateSnapshotRequest::Representation
+          command.request_object = create_snapshot_request_object
+          command.response_representation = Google::Apis::PubsubV1::Snapshot::Representation
+          command.response_class = Google::Apis::PubsubV1::Snapshot
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Removes an existing snapshot. All messages retained in the snapshot
+        # are immediately dropped. After a snapshot is deleted, a new one may be
+        # created with the same name, but the new one has no association with the old
+        # snapshot or its subscription, unless the same subscription is specified.
+        # @param [String] snapshot
+        #   The name of the snapshot to delete.
+        #   Format is `projects/`project`/snapshots/`snap``.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::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 delete_project_snapshot(snapshot, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1/{+snapshot}', options)
+          command.response_representation = Google::Apis::PubsubV1::Empty::Representation
+          command.response_class = Google::Apis::PubsubV1::Empty
+          command.params['snapshot'] = snapshot unless snapshot.nil?
+          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.
         # Returns an empty policy if the resource exists and does not have a policy
         # set.
@@ -80,6 +163,79 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists the existing snapshots.
+        # @param [String] project
+        #   The name of the cloud project that snapshots belong to.
+        #   Format is `projects/`project``.
+        # @param [Fixnum] page_size
+        #   Maximum number of snapshots to return.
+        # @param [String] page_token
+        #   The value returned by the last `ListSnapshotsResponse`; indicates that this
+        #   is a continuation of a prior `ListSnapshots` call, and that the system
+        #   should return the next page of data.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::ListSnapshotsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::ListSnapshotsResponse]
+        #
+        # @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_project_snapshots(project, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+project}/snapshots', options)
+          command.response_representation = Google::Apis::PubsubV1::ListSnapshotsResponse::Representation
+          command.response_class = Google::Apis::PubsubV1::ListSnapshotsResponse
+          command.params['project'] = project unless project.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates an existing snapshot. Note that certain properties of a
+        # snapshot are not modifiable.
+        # @param [String] name
+        #   The name of the snapshot.
+        # @param [Google::Apis::PubsubV1::UpdateSnapshotRequest] update_snapshot_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
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::Snapshot] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::Snapshot]
+        #
+        # @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 patch_project_snapshot(name, update_snapshot_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::PubsubV1::UpdateSnapshotRequest::Representation
+          command.request_object = update_snapshot_request_object
+          command.response_representation = Google::Apis::PubsubV1::Snapshot::Representation
+          command.response_class = Google::Apis::PubsubV1::Snapshot
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
         # @param [String] resource
@@ -453,6 +609,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates an existing subscription. Note that certain properties of a
+        # subscription, such as its topic, are not modifiable.
+        # @param [String] name
+        #   The name of the subscription. It must have the format
+        #   `"projects/`project`/subscriptions/`subscription`"`. ``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::PubsubV1::UpdateSubscriptionRequest] update_subscription_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
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::Subscription] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::Subscription]
+        #
+        # @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 patch_project_subscription(name, update_subscription_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::PubsubV1::UpdateSubscriptionRequest::Representation
+          command.request_object = update_subscription_request_object
+          command.response_representation = Google::Apis::PubsubV1::Subscription::Representation
+          command.response_class = Google::Apis::PubsubV1::Subscription
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Pulls messages from the server. Returns an empty list if there are no
         # messages available in the backlog. The server may return `UNAVAILABLE` if
         # there are too many concurrent pull requests pending for the given
@@ -490,6 +685,40 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Seeks an existing subscription to a point in time or to a given snapshot,
+        # whichever is provided in the request.
+        # @param [String] subscription
+        #   The subscription to affect.
+        # @param [Google::Apis::PubsubV1::SeekRequest] seek_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
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::SeekResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::SeekResponse]
+        #
+        # @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 seek_subscription(subscription, seek_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+subscription}:seek', options)
+          command.request_representation = Google::Apis::PubsubV1::SeekRequest::Representation
+          command.request_object = seek_request_object
+          command.response_representation = Google::Apis::PubsubV1::SeekResponse::Representation
+          command.response_class = Google::Apis::PubsubV1::SeekResponse
+          command.params['subscription'] = subscription unless subscription.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
         # @param [String] resource
@@ -850,7 +1079,46 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the name of the subscriptions for this topic.
+        # Lists the names of the snapshots on this topic.
+        # @param [String] topic
+        #   The name of the topic that snapshots are attached to.
+        #   Format is `projects/`project`/topics/`topic``.
+        # @param [Fixnum] page_size
+        #   Maximum number of snapshot names to return.
+        # @param [String] page_token
+        #   The value returned by the last `ListTopicSnapshotsResponse`; indicates
+        #   that this is a continuation of a prior `ListTopicSnapshots` call, and
+        #   that the system should return the next page of data.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::PubsubV1::ListTopicSnapshotsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::PubsubV1::ListTopicSnapshotsResponse]
+        #
+        # @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_project_topic_snapshots(topic, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+topic}/snapshots', options)
+          command.response_representation = Google::Apis::PubsubV1::ListTopicSnapshotsResponse::Representation
+          command.response_class = Google::Apis::PubsubV1::ListTopicSnapshotsResponse
+          command.params['topic'] = topic unless topic.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the names of the subscriptions on this topic.
         # @param [String] topic
         #   The name of the topic that subscriptions are attached to.
         #   Format is `projects/`project`/topics/`topic``.

data/generated/google/apis/speech_v1.rb

@@ -25,10 +25,13 @@ module Google
     # @see https://cloud.google.com/speech/
     module SpeechV1
       VERSION = 'V1'
-      REVISION = '20171018'
+      REVISION = '20171129'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # Convert speech to text using Google speech recognition technology
+      AUTH_CLOUD_SPEECH = 'https://www.googleapis.com/auth/cloud-speech'
     end
   end
 end

data/generated/google/apis/speech_v1beta1.rb

@@ -25,10 +25,13 @@ module Google
     # @see https://cloud.google.com/speech/
     module SpeechV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20170829'
+      REVISION = '20171129'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # Convert speech to text using Google speech recognition technology
+      AUTH_CLOUD_SPEECH = 'https://www.googleapis.com/auth/cloud-speech'
     end
   end
 end

data/generated/google/apis/testing_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/cloud-test-lab/
     module TestingV1
       VERSION = 'V1'
-      REVISION = '20171012'
+      REVISION = '20171129'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/testing_v1/classes.rb

@@ -904,7 +904,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # A human-friendy string representing the region for this locale.
+        # A human-friendly string representing the region for this locale.
         # Example: "United States"
         # Not present for every locale.
         # @OutputOnly

data/generated/google/apis/youtube_partner_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/youtube/partner/
     module YoutubePartnerV1
       VERSION = 'V1'
-      REVISION = '20171113'
+      REVISION = '20171127'
 
       # View and manage your assets and associated content on YouTube
       AUTH_YOUTUBEPARTNER = 'https://www.googleapis.com/auth/youtubepartner'

data/generated/google/apis/youtube_v3.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/youtube/v3
     module YoutubeV3
       VERSION = 'V3'
-      REVISION = '20171101'
+      REVISION = '20171129'
 
       # Manage your YouTube account
       AUTH_YOUTUBE = 'https://www.googleapis.com/auth/youtube'

data/generated/google/apis/youtube_v3/classes.rb

@@ -3747,6 +3747,12 @@ module Google
         # @return [String]
         attr_accessor :closed_captions_type
       
+        # This setting indicates whether auto start is enabled for this broadcast.
+        # Corresponds to the JSON property `enableAutoStart`
+        # @return [Boolean]
+        attr_accessor :enable_auto_start
+        alias_method :enable_auto_start?, :enable_auto_start
+      
         # This setting indicates whether HTTP POST closed captioning is enabled for this
         # broadcast. The ingestion URL of the closed captions is returned through the
         # liveStreams API. This is mutually exclusive with using the
@@ -3845,6 +3851,7 @@ module Google
           @bound_stream_id = args[:bound_stream_id] if args.key?(:bound_stream_id)
           @bound_stream_last_update_time_ms = args[:bound_stream_last_update_time_ms] if args.key?(:bound_stream_last_update_time_ms)
           @closed_captions_type = args[:closed_captions_type] if args.key?(:closed_captions_type)
+          @enable_auto_start = args[:enable_auto_start] if args.key?(:enable_auto_start)
           @enable_closed_captions = args[:enable_closed_captions] if args.key?(:enable_closed_captions)
           @enable_content_encryption = args[:enable_content_encryption] if args.key?(:enable_content_encryption)
           @enable_dvr = args[:enable_dvr] if args.key?(:enable_dvr)
@@ -6956,6 +6963,11 @@ module Google
       class Video
         include Google::Apis::Core::Hashable
       
+        # The access token to uniquely identify a revocable unlisted video.
+        # Corresponds to the JSON property `accessToken`
+        # @return [String]
+        attr_accessor :access_token
+      
         # Age restriction details related to a video. This data can only be retrieved by
         # the video owner.
         # Corresponds to the JSON property `ageGating`
@@ -7060,6 +7072,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @access_token = args[:access_token] if args.key?(:access_token)
           @age_gating = args[:age_gating] if args.key?(:age_gating)
           @content_details = args[:content_details] if args.key?(:content_details)
           @etag = args[:etag] if args.key?(:etag)

data/generated/google/apis/youtube_v3/representations.rb

@@ -2035,6 +2035,7 @@ module Google
           property :bound_stream_last_update_time_ms, as: 'boundStreamLastUpdateTimeMs', type: DateTime
       
           property :closed_captions_type, as: 'closedCaptionsType'
+          property :enable_auto_start, as: 'enableAutoStart'
           property :enable_closed_captions, as: 'enableClosedCaptions'
           property :enable_content_encryption, as: 'enableContentEncryption'
           property :enable_dvr, as: 'enableDvr'
@@ -2902,6 +2903,7 @@ module Google
       class Video
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :access_token, as: 'accessToken'
           property :age_gating, as: 'ageGating', class: Google::Apis::YoutubeV3::VideoAgeGating, decorator: Google::Apis::YoutubeV3::VideoAgeGating::Representation
       
           property :content_details, as: 'contentDetails', class: Google::Apis::YoutubeV3::VideoContentDetails, decorator: Google::Apis::YoutubeV3::VideoContentDetails::Representation

data/lib/google/apis/core/base_service.rb

@@ -400,7 +400,10 @@ module Google
         def new_client
           client = ::HTTPClient.new
 
-          client.transparent_gzip_decompression = true
+          if client_options.transparent_gzip_decompression
+            client.transparent_gzip_decompression = client_options.transparent_gzip_decompression
+          end
+          
           client.proxy = client_options.proxy_url if client_options.proxy_url
 
           if client_options.open_timeout_sec

data/lib/google/apis/options.rb

@@ -22,7 +22,8 @@ module Google
       :open_timeout_sec,
       :read_timeout_sec,
       :send_timeout_sec,
-      :log_http_requests)
+      :log_http_requests,
+      :transparent_gzip_decompression)
 
     RequestOptions = Struct.new(
       :authorization,
@@ -47,6 +48,8 @@ module Google
       #   @return [Fixnum] How long, in seconds, before failed connections time out
       # @!attribute [rw] read_timeout_sec
       #   @return [Fixnum] How long, in seconds, before requests time out
+      # @!attribute [rw] transparent_gzip_decompression
+      # @return [Boolean] True if gzip compression needs to be enabled
       # Get the default options
       # @return [Google::Apis::ClientOptions]
       def self.default
@@ -92,6 +95,7 @@ module Google
     ClientOptions.default.log_http_requests = false
     ClientOptions.default.application_name = 'unknown'
     ClientOptions.default.application_version = '0.0.0'
+    ClientOptions.default.transparent_gzip_decompression = true
     RequestOptions.default.retries = 0
     RequestOptions.default.normalize_unicode = false
     RequestOptions.default.skip_serialization = false