google-apis-youtube_v3 0.57.0 → 0.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65f5728729c027ad8d48532d9d34d5f505214e01ab24cec299b3cee85a7be2e5
-  data.tar.gz: 72e423350cf43f687117f2329b09fda738ac91ada832eae941f39c68634ab202
+  metadata.gz: 11b31e042e010ad3c0e2d6a9906044512b74281c5aa9d3d05bf6392174fca932
+  data.tar.gz: c160b513c2fcecd05d91e3c2397f91df82a2e468b2a85d1301f84d76d2ebe91d
 SHA512:
-  metadata.gz: b3613875df7c1c40f8e5f8c65042ee9b2aab58f44e5822837b32a47965c6ee210ad85e42fa3fb71add3f96b96257b1cc2ce730eb88ddedd6c2b755bba3cc9ca2
-  data.tar.gz: ecbb93d6bf9a7d841d571c5a6c9cbf6ccd40b567713e016cfa7c2d3b383104e0404e31af82e039e2a0bc40e9c2996061a6ad32d3858137f66917d9d05a49e6ab
+  metadata.gz: 8e66c4db3516cc8f2e58da133b5b952aa88bcdb43b809ac4a48de055fe4c67728c64d99355e5ee3ed29b33d84ae902e43b0de8efc51d36eb8b2750694757a569
+  data.tar.gz: 8d1cf2604b29c4ab99a00b3798800e8050c7142bcb8056a92fa174012fd6d454937500b161700efa5da50a1d311292f218f2b5a10774866bd361f5eb076beaa9

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-youtube_v3
 
+### v0.58.0 (2025-11-30)
+
+* Regenerated from discovery document revision 20251125
+
 ### v0.57.0 (2025-07-20)
 
 * Regenerated from discovery document revision 20250714

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

@@ -697,6 +697,40 @@ module Google
         end
       end
       
+      # Response for the Videos.stats API. Returns VideoStat information about a batch
+      # of videos. VideoStat contains a subset of the information in Video that is
+      # relevant to statistics and content details.
+      class BatchGetStatsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Etag of this resource.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Output only. The videos' stats information.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::YoutubeV3::VideoStat>]
+        attr_accessor :items
+      
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # "youtube#batchGetStatsResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @etag = args[:etag] if args.key?(:etag)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+        end
+      end
+      
       # A *caption* resource represents a YouTube caption track. A caption track is
       # associated with exactly one YouTube video.
       class Caption
@@ -9015,6 +9049,66 @@ module Google
         end
       end
       
+      # A *VideoStat* resource represents a YouTube video's stats.
+      class VideoStat
+        include Google::Apis::Core::Hashable
+      
+        # Details about the content of a YouTube Video. This is a subset of the
+        # information in VideoContentDetails specifically for the Videos.stats API.
+        # Corresponds to the JSON property `contentDetails`
+        # @return [Google::Apis::YoutubeV3::VideoStatsContentDetails]
+        attr_accessor :content_details
+      
+        # Output only. Etag of this resource.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Output only. Identifies what kind of resource this is. Value: the fixed string
+        # "youtube#videoStats".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Output only. Identifier. The resource name for the `VideoStats` resource, in
+        # the format `videoStats/`video_stat``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Basic details about a video. This is a subset of the information in
+        # VideoSnippet specifically for the Videos.stats API.
+        # Corresponds to the JSON property `snippet`
+        # @return [Google::Apis::YoutubeV3::VideoStatsSnippet]
+        attr_accessor :snippet
+      
+        # Statistics about the video, such as the number of times the video was viewed
+        # or liked.
+        # Corresponds to the JSON property `statistics`
+        # @return [Google::Apis::YoutubeV3::VideoStatsStatistics]
+        attr_accessor :statistics
+      
+        # Output only. The ID that YouTube uses to uniquely identify the video.
+        # Corresponds to the JSON property `videoId`
+        # @return [String]
+        attr_accessor :video_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @content_details = args[:content_details] if args.key?(:content_details)
+          @etag = args[:etag] if args.key?(:etag)
+          @kind = args[:kind] if args.key?(:kind)
+          @name = args[:name] if args.key?(:name)
+          @snippet = args[:snippet] if args.key?(:snippet)
+          @statistics = args[:statistics] if args.key?(:statistics)
+          @video_id = args[:video_id] if args.key?(:video_id)
+        end
+      end
+      
       # Statistics about the video, such as the number of times the video was viewed
       # or liked.
       class VideoStatistics
@@ -9061,6 +9155,83 @@ module Google
         end
       end
       
+      # Details about the content of a YouTube Video. This is a subset of the
+      # information in VideoContentDetails specifically for the Videos.stats API.
+      class VideoStatsContentDetails
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The length of the video. The property value is a [`google.
+        # protobuf.Duration`](https://developers.google.com/protocol-buffers/docs/
+        # reference/google.protobuf#duration) object.
+        # Corresponds to the JSON property `duration`
+        # @return [String]
+        attr_accessor :duration
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @duration = args[:duration] if args.key?(:duration)
+        end
+      end
+      
+      # Basic details about a video. This is a subset of the information in
+      # VideoSnippet specifically for the Videos.stats API.
+      class VideoStatsSnippet
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The date and time that the video was uploaded. The property value
+        # is a [`google.protobuf.Timestamp`](https://developers.google.com/protocol-
+        # buffers/docs/reference/google.protobuf#timestamp) object.
+        # Corresponds to the JSON property `publishTime`
+        # @return [String]
+        attr_accessor :publish_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @publish_time = args[:publish_time] if args.key?(:publish_time)
+        end
+      end
+      
+      # Statistics about the video, such as the number of times the video was viewed
+      # or liked.
+      class VideoStatsStatistics
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The number of comments for the video.
+        # Corresponds to the JSON property `commentCount`
+        # @return [Fixnum]
+        attr_accessor :comment_count
+      
+        # Output only. The number of users who have indicated that they liked the video
+        # by giving it a positive rating.
+        # Corresponds to the JSON property `likeCount`
+        # @return [Fixnum]
+        attr_accessor :like_count
+      
+        # Output only. The number of times the video has been viewed.
+        # Corresponds to the JSON property `viewCount`
+        # @return [Fixnum]
+        attr_accessor :view_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @comment_count = args[:comment_count] if args.key?(:comment_count)
+          @like_count = args[:like_count] if args.key?(:like_count)
+          @view_count = args[:view_count] if args.key?(:view_count)
+        end
+      end
+      
       # Basic details about a video category, such as its localized title. Next Id: 19
       class VideoStatus
         include Google::Apis::Core::Hashable

data/lib/google/apis/youtube_v3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module YoutubeV3
       # Version of the google-apis-youtube_v3 gem
-      GEM_VERSION = "0.57.0"
+      GEM_VERSION = "0.58.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250714"
+      REVISION = "20251125"
     end
   end
 end

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

@@ -130,6 +130,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BatchGetStatsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Caption
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1174,12 +1180,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class VideoStat
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class VideoStatistics
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class VideoStatsContentDetails
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class VideoStatsSnippet
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class VideoStatsStatistics
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class VideoStatus
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1423,6 +1453,16 @@ module Google
         end
       end
       
+      class BatchGetStatsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :etag, as: 'etag'
+          collection :items, as: 'items', class: Google::Apis::YoutubeV3::VideoStat, decorator: Google::Apis::YoutubeV3::VideoStat::Representation
+      
+          property :kind, as: 'kind'
+        end
+      end
+      
       class Caption
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3604,6 +3644,22 @@ module Google
         end
       end
       
+      class VideoStat
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :content_details, as: 'contentDetails', class: Google::Apis::YoutubeV3::VideoStatsContentDetails, decorator: Google::Apis::YoutubeV3::VideoStatsContentDetails::Representation
+      
+          property :etag, as: 'etag'
+          property :kind, as: 'kind'
+          property :name, as: 'name'
+          property :snippet, as: 'snippet', class: Google::Apis::YoutubeV3::VideoStatsSnippet, decorator: Google::Apis::YoutubeV3::VideoStatsSnippet::Representation
+      
+          property :statistics, as: 'statistics', class: Google::Apis::YoutubeV3::VideoStatsStatistics, decorator: Google::Apis::YoutubeV3::VideoStatsStatistics::Representation
+      
+          property :video_id, as: 'videoId'
+        end
+      end
+      
       class VideoStatistics
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3615,6 +3671,29 @@ module Google
         end
       end
       
+      class VideoStatsContentDetails
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :duration, as: 'duration'
+        end
+      end
+      
+      class VideoStatsSnippet
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :publish_time, as: 'publishTime'
+        end
+      end
+      
+      class VideoStatsStatistics
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :comment_count, :numeric_string => true, as: 'commentCount'
+          property :like_count, :numeric_string => true, as: 'likeCount'
+          property :view_count, :numeric_string => true, as: 'viewCount'
+        end
+      end
+      
       class VideoStatus
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/youtube_v3/service.rb

@@ -4242,6 +4242,56 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Retrieves a batch of VideoStat resources, possibly filtered.
+        # @param [String] on_behalf_of_content_owner
+        #   Optional. **Note:** This parameter is intended exclusively for YouTube content
+        #   partners. The `onBehalfOfContentOwner` parameter indicates that the request's
+        #   authorization credentials identify a YouTube CMS user who is acting on behalf
+        #   of the content owner specified in the parameter value. This parameter is
+        #   intended for YouTube content partners that own and manage many different
+        #   YouTube channels. It allows content owners to authenticate once and get access
+        #   to all their video and channel data, without having to provide authentication
+        #   credentials for each individual channel. The CMS account that the user
+        #   authenticates with must be linked to the specified YouTube content owner.
+        # @param [Array<String>, String] part
+        #   Required. The `**part**` parameter specifies a comma-separated list of one or
+        #   more `videoStat` resource properties that the API response will include. If
+        #   the parameter identifies a property that contains child properties, the child
+        #   properties will be included in the response. For example, in a `videoStat`
+        #   resource, the `statistics` property contains `view_count` and `like_count`. As
+        #   such, if you set `**part=snippet**`, the API response will contain all of
+        #   those properties.
+        # @param [Array<String>, String] video_ids
+        #   Required. Return videos with the given ids.
+        # @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::YoutubeV3::BatchGetStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::YoutubeV3::BatchGetStatsResponse]
+        #
+        # @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 batch_youtube_v3_video_get_stats(on_behalf_of_content_owner: nil, part: nil, video_ids: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'youtube/v3/videos:batchGetStats', options)
+          command.response_representation = Google::Apis::YoutubeV3::BatchGetStatsResponse::Representation
+          command.response_class = Google::Apis::YoutubeV3::BatchGetStatsResponse
+          command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
+          command.query['part'] = part unless part.nil?
+          command.query['videoIds'] = video_ids unless video_ids.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-youtube_v3
 version: !ruby/object:Gem::Version
-  version: 0.57.0
+  version: 0.58.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-youtube_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-youtube_v3/v0.57.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-youtube_v3/v0.58.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-youtube_v3
 rdoc_options: []
 require_paths: