Class: Google::Apis::YoutubePartnerV1::Metadata

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
generated/google/apis/youtube_partner_v1/classes.rb,
generated/google/apis/youtube_partner_v1/representations.rb,
generated/google/apis/youtube_partner_v1/representations.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Core::JsonObjectSupport

#to_json

Methods included from Core::Hashable

process_value, #to_h

Constructor Details

#initialize(**args) ⇒ Metadata

Returns a new instance of Metadata



2212
2213
2214
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2212

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#actorArray<String>

A list that identifies actors associated with the asset. You can specify up to 50 actors for an asset. Corresponds to the JSON property actor

Returns:

  • (Array<String>)


1930
1931
1932
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1930

def actor
  @actor
end

#albumString

The album on which a sound recording asset is included. This field is only valid for sound recording assets and has a maximum length of 255 bytes. Corresponds to the JSON property album

Returns:

  • (String)


1936
1937
1938
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1936

def album
  @album
end

#artistArray<String>

The artist associated with a music video or sound recording asset. This field is only valid for music video and sound recording assets. It is required for sound recordings included in the AudioSwap program. Corresponds to the JSON property artist

Returns:

  • (Array<String>)


1943
1944
1945
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1943

def artist
  @artist
end

#broadcasterArray<String>

Identifies the network or channel that originally broadcast a show or a season of a show. This field should only be included for an asset if the broadcaster associated with the asset is different from the partner uploading the asset to YouTube. Note that a show may have multiple broadcasters; for example, a show may switch networks between seasons. Corresponds to the JSON property broadcaster

Returns:

  • (Array<String>)


1952
1953
1954
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1952

def broadcaster
  @broadcaster
end

#categoryString

Category of this asset. Corresponds to the JSON property category

Returns:

  • (String)


1957
1958
1959
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1957

def category
  @category
end

#content_typeString

The type of video content that the asset represents. This field is only valid for movie and episode assets, and is required for the following types of those assets:

  • Episode assets that are linked to a show
  • Movie assets that appear in YouTube's Movies category Corresponds to the JSON property contentType

Returns:

  • (String)


1966
1967
1968
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1966

def content_type
  @content_type
end

The date copyright for this asset was established. * Corresponds to the JSON property copyrightDate



1971
1972
1973
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1971

def copyright_date
  @copyright_date
end

#custom_idString

A unique value that you, the metadata provider, use to identify an asset. The value could be a unique ID that you created for the asset or a standard identifier, such as an ISRC. The value has a maximum length of 64 bytes and may contain alphanumeric characters, hyphens (-), underscores (_), periods (.), "at" symbols (@), or forward slashes (/). Corresponds to the JSON property customId

Returns:

  • (String)


1980
1981
1982
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1980

def custom_id
  @custom_id
end

#descriptionString

A description of the asset. The description may be displayed on YouTube or in CMS. This field has a maximum length of 5,000 bytes. Corresponds to the JSON property description

Returns:

  • (String)


1986
1987
1988
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1986

def description
  @description
end

#directorArray<String>

A list that identifies directors associated with the asset. You can specify up to 50 directors for an asset. Corresponds to the JSON property director

Returns:

  • (Array<String>)


1992
1993
1994
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 1992

def director
  @director
end

#eidrString

The Entertainment Identifier Registry (EIDR) assigned to an asset. This value is only used for episode and movie assets and is optional in both cases. The value contains a standard prefix for EIDR registry, followed by a forward slash, a 20-character hexadecimal string, and an alphanumeric (0-9A-Z) check character. Corresponds to the JSON property eidr

Returns:

  • (String)


2001
2002
2003
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2001

def eidr
  @eidr
end

#end_yearFixnum

The last year that a television show aired. This value is only used for show assets, for which it is optional. Do not specify a value if new show episodes are still being created. Corresponds to the JSON property endYear

Returns:

  • (Fixnum)


2008
2009
2010
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2008

def end_year
  @end_year
end

#episode_numberString

The episode number associated with an episode asset. This field is required for and only used for episode assets that are linked to show assets. It has a maximum length of 5 bytes. Corresponds to the JSON property episodeNumber

Returns:

  • (String)


2015
2016
2017
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2015

def episode_number
  @episode_number
end

#episodes_are_untitledBoolean Also known as: episodes_are_untitled?

This value indicates that the episodes associated with a particular show asset or a particular season asset are untitled. An untitled show (or season) has episodes which are identified by their episode number or date. If this field is set to true, then YouTube will optimize the title displayed for associated episodes. Corresponds to the JSON property episodesAreUntitled

Returns:

  • (Boolean)


2024
2025
2026
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2024

def episodes_are_untitled
  @episodes_are_untitled
end

#genreArray<String>

This field specifies a genre that can be used to categorize an asset. Assets may be categorized in more than one genre, and YouTube uses different sets of genres to categorize different types of assets. For example, Soaps might be a valid genre for a show but not for a movie or sound recording.

  • Show assets
  • Movie assets that appear in YouTube's Movies category
  • Sound recordings included in the AudioSwap program Corresponds to the JSON property genre

Returns:

  • (Array<String>)


2036
2037
2038
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2036

def genre
  @genre
end

#gridString

The GRID (Global Release Identifier) of a music video or sound recording. This field's value must contain exactly 18 alphanumeric characters. Corresponds to the JSON property grid

Returns:

  • (String)


2042
2043
2044
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2042

def grid
  @grid
end

#hfaString

The six-character Harry Fox Agency (HFA) song code issued to uniquely identify a composition. This value is only valid for composition assets. Corresponds to the JSON property hfa

Returns:

  • (String)


2048
2049
2050
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2048

def hfa
  @hfa
end

#info_urlString

An official URL associated with the asset. This field has a maximum length of 1536 bytes. Please do not submit a 1537-byte URL. Your efforts would be futile. Corresponds to the JSON property infoUrl

Returns:

  • (String)


2054
2055
2056
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2054

def info_url
  @info_url
end

#isanString

The ISAN (International Standard Audiovisual Number) for the asset. This value is only used for episode and movie assets and is optional in both cases. The value contains 26 characters, which includes the 24 hexadecimal characters of the ISAN as well as two check characters, in the following format:

  • The first 16 characters in the tag value contain hexadecimal characters specifying the 'root' and 'episode' components of the ISAN.
  • The seventeenth character is a check character (a letter from A-Z).
  • Characters 18 to 25 are the remaining eight characters of the ISAN, which specify the 'version' component of the ISAN.
  • The twenty-sixth character is another check character (A-Z). Corresponds to the JSON property isan

Returns:

  • (String)


2068
2069
2070
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2068

def isan
  @isan
end

#isrcString

The ISRC (International Standard Recording Code) of a music video or sound recording asset. This field's value must contain exactly 12 alphanumeric characters. Corresponds to the JSON property isrc

Returns:

  • (String)


2075
2076
2077
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2075

def isrc
  @isrc
end

#iswcString

The ISWC (International Standard Musical Work Code) for a composition asset. The field's value must contain exactly 11 characters in the format of a letter (T) followed by 10 digits. Corresponds to the JSON property iswc

Returns:

  • (String)


2082
2083
2084
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2082

def iswc
  @iswc
end

#keywordArray<String>

A list of up to 100 keywords associated with a show asset. This field is required for and also only used for show assets. Corresponds to the JSON property keyword

Returns:

  • (Array<String>)


2088
2089
2090
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2088

def keyword
  @keyword
end

#labelString

The record label that released a sound recording asset. This field is only valid for sound recording assets and has a maximum length of 255 bytes. Corresponds to the JSON property label

Returns:

  • (String)


2094
2095
2096
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2094

def label
  @label
end

#notesString

Additional information that does not map directly to one of the other metadata fields. This field has a maximum length of 255 bytes. Corresponds to the JSON property notes

Returns:

  • (String)


2100
2101
2102
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2100

def notes
  @notes
end

#original_release_mediumString

The method by which people first had the opportunity to see a video asset. This value is only used for episode and movie assets. It is required for the assets listed below and otherwise optional:

  • Episode assets that are linked to a show
  • Movie assets that appear in YouTube's Movies category Corresponds to the JSON property originalReleaseMedium

Returns:

  • (String)


2109
2110
2111
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2109

def original_release_medium
  @original_release_medium
end

#producerArray<String>

A list that identifies producers of the asset. You can specify up to 50 producers for an asset. Corresponds to the JSON property producer

Returns:

  • (Array<String>)


2115
2116
2117
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2115

def producer
  @producer
end

#ratingsArray<Google::Apis::YoutubePartnerV1::Rating>

A list of ratings that an asset received. The rating must be valid under the specified rating system. Corresponds to the JSON property ratings



2121
2122
2123
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2121

def ratings
  @ratings
end

#release_dateGoogle::Apis::YoutubePartnerV1::Date

The date that an asset was publicly released. For season assets, this value specifies the first date that the season aired. Dates prior to the year 1902 are not supported. This value is valid for episode, season, movie, music video, and sound recording assets. It is required for the assets listed below and otherwise optional:

  • Episode assets that are linked to a show
  • Movie assets that appear in YouTube's Movies category Corresponds to the JSON property releaseDate


2132
2133
2134
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2132

def release_date
  @release_date
end

#season_numberString

The season number that identifies a season asset, or the season number that is associated with an episode asset. This field has a maximum length of 5 bytes. Corresponds to the JSON property seasonNumber

Returns:

  • (String)


2138
2139
2140
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2138

def season_number
  @season_number
end

#show_custom_idString

The customId of the show asset that a season or episode asset is associated with. It is required for season and episode assets that appear in the Shows category on YouTube, and it is not valid for other types of assets. This field has a maximum length of 64 bytes and may contain alphanumeric characters, hyphens (-), underscores (_), periods (.), "at" symbols (@), or forward slashes (/). Corresponds to the JSON property showCustomId

Returns:

  • (String)


2148
2149
2150
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2148

def show_custom_id
  @show_custom_id
end

#show_titleString

The name of the show that an episode asset is associated with. Note: This tag is only used for and valid for episodes that are not associated with show assets and enables those assets to still display a show title in the asset metadata section of CMS. This field has a maximum length of 120 bytes. Corresponds to the JSON property showTitle

Returns:

  • (String)


2156
2157
2158
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2156

def show_title
  @show_title
end

#spoken_languageString

The video's primary spoken language. The value can be any ISO 639-1 two-letter language code. This value is only used for episode and movie assets and is not valid for other types of assets. Corresponds to the JSON property spokenLanguage

Returns:

  • (String)


2163
2164
2165
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2163

def spoken_language
  @spoken_language
end

#start_yearFixnum

The first year that a television show aired. This value is required for and also only used for show assets. Corresponds to the JSON property startYear

Returns:

  • (Fixnum)


2169
2170
2171
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2169

def start_year
  @start_year
end

#subtitled_languageArray<String>

A list of languages for which the video has either a separate caption track or burnt-in captions that are part of the video. Each value in the list should be an ISO 639-1 two-letter language code. This value is only used for episode and movie assets and is not valid for other types of assets. Corresponds to the JSON property subtitledLanguage

Returns:

  • (Array<String>)


2177
2178
2179
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2177

def subtitled_language
  @subtitled_language
end

#titleString

The asset's title or name. The value has a maximum length of 255 bytes. This value is required for the assets listed below and optional for all other assets:

  • Show assets
  • Episode assets that are linked to a show
  • Movie assets that appear in YouTube's Movies category
  • Sound recordings included in the AudioSwap program Corresponds to the JSON property title

Returns:

  • (String)


2188
2189
2190
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2188

def title
  @title
end

#tms_idString

TMS (Tribune Media Systems) ID for the asset. Corresponds to the JSON property tmsId

Returns:

  • (String)


2193
2194
2195
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2193

def tms_id
  @tms_id
end

#total_episodes_expectedFixnum

Specifies the total number of full-length episodes in the season. This value is used only for season assets. Corresponds to the JSON property totalEpisodesExpected

Returns:

  • (Fixnum)


2199
2200
2201
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2199

def total_episodes_expected
  @total_episodes_expected
end

#upcString

The UPC (Universal Product Code) associated with the asset. Corresponds to the JSON property upc

Returns:

  • (String)


2204
2205
2206
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2204

def upc
  @upc
end

#writerArray<String>

A list that identifies writers associated with the asset. You can specify up to 50 writers for an asset. Corresponds to the JSON property writer

Returns:

  • (Array<String>)


2210
2211
2212
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2210

def writer
  @writer
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
# File 'generated/google/apis/youtube_partner_v1/classes.rb', line 2217

def update!(**args)
  @actor = args[:actor] if args.key?(:actor)
  @album = args[:album] if args.key?(:album)
  @artist = args[:artist] if args.key?(:artist)
  @broadcaster = args[:broadcaster] if args.key?(:broadcaster)
  @category = args[:category] if args.key?(:category)
  @content_type = args[:content_type] if args.key?(:content_type)
  @copyright_date = args[:copyright_date] if args.key?(:copyright_date)
  @custom_id = args[:custom_id] if args.key?(:custom_id)
  @description = args[:description] if args.key?(:description)
  @director = args[:director] if args.key?(:director)
  @eidr = args[:eidr] if args.key?(:eidr)
  @end_year = args[:end_year] if args.key?(:end_year)
  @episode_number = args[:episode_number] if args.key?(:episode_number)
  @episodes_are_untitled = args[:episodes_are_untitled] if args.key?(:episodes_are_untitled)
  @genre = args[:genre] if args.key?(:genre)
  @grid = args[:grid] if args.key?(:grid)
  @hfa = args[:hfa] if args.key?(:hfa)
  @info_url = args[:info_url] if args.key?(:info_url)
  @isan = args[:isan] if args.key?(:isan)
  @isrc = args[:isrc] if args.key?(:isrc)
  @iswc = args[:iswc] if args.key?(:iswc)
  @keyword = args[:keyword] if args.key?(:keyword)
  @label = args[:label] if args.key?(:label)
  @notes = args[:notes] if args.key?(:notes)
  @original_release_medium = args[:original_release_medium] if args.key?(:original_release_medium)
  @producer = args[:producer] if args.key?(:producer)
  @ratings = args[:ratings] if args.key?(:ratings)
  @release_date = args[:release_date] if args.key?(:release_date)
  @season_number = args[:season_number] if args.key?(:season_number)
  @show_custom_id = args[:show_custom_id] if args.key?(:show_custom_id)
  @show_title = args[:show_title] if args.key?(:show_title)
  @spoken_language = args[:spoken_language] if args.key?(:spoken_language)
  @start_year = args[:start_year] if args.key?(:start_year)
  @subtitled_language = args[:subtitled_language] if args.key?(:subtitled_language)
  @title = args[:title] if args.key?(:title)
  @tms_id = args[:tms_id] if args.key?(:tms_id)
  @total_episodes_expected = args[:total_episodes_expected] if args.key?(:total_episodes_expected)
  @upc = args[:upc] if args.key?(:upc)
  @writer = args[:writer] if args.key?(:writer)
end