| <html><body> |
| <style> |
| |
| body, h1, h2, h3, div, span, p, pre, a { |
| margin: 0; |
| padding: 0; |
| border: 0; |
| font-weight: inherit; |
| font-style: inherit; |
| font-size: 100%; |
| font-family: inherit; |
| vertical-align: baseline; |
| } |
| |
| body { |
| font-size: 13px; |
| padding: 1em; |
| } |
| |
| h1 { |
| font-size: 26px; |
| margin-bottom: 1em; |
| } |
| |
| h2 { |
| font-size: 24px; |
| margin-bottom: 1em; |
| } |
| |
| h3 { |
| font-size: 20px; |
| margin-bottom: 1em; |
| margin-top: 1em; |
| } |
| |
| pre, code { |
| line-height: 1.5; |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| } |
| |
| pre { |
| margin-top: 0.5em; |
| } |
| |
| h1, h2, h3, p { |
| font-family: Arial, sans serif; |
| } |
| |
| h1, h2, h3 { |
| border-bottom: solid #CCC 1px; |
| } |
| |
| .toc_element { |
| margin-top: 0.5em; |
| } |
| |
| .firstline { |
| margin-left: 2 em; |
| } |
| |
| .method { |
| margin-top: 1em; |
| border: solid 1px #CCC; |
| padding: 1em; |
| background: #EEE; |
| } |
| |
| .details { |
| font-weight: bold; |
| font-size: 14px; |
| } |
| |
| </style> |
| |
| <h1><a href="youtube_v3.html">YouTube Data API v3</a> . <a href="youtube_v3.videos.html">videos</a></h1> |
| <h2>Instance Methods</h2> |
| <p class="toc_element"> |
| <code><a href="#delete">delete(id, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Deletes a resource.</p> |
| <p class="toc_element"> |
| <code><a href="#getRating">getRating(id, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Retrieves the ratings that the authorized user gave to a list of specified</p> |
| <p class="toc_element"> |
| <code><a href="#insert">insert(part, body=None, autoLevels=None, stabilize=None, onBehalfOfContentOwnerChannel=None, notifySubscribers=None, onBehalfOfContentOwner=None, x__xgafv=None, media_body=None, media_mime_type=None)</a></code></p> |
| <p class="firstline">Inserts a new resource into this collection.</p> |
| <p class="toc_element"> |
| <code><a href="#list">list(part, myRating=None, locale=None, chart=None, videoCategoryId=None, maxWidth=None, regionCode=None, maxHeight=None, id=None, maxResults=None, onBehalfOfContentOwner=None, hl=None, pageToken=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Retrieves a list of resources, possibly filtered.</p> |
| <p class="toc_element"> |
| <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| <p class="firstline">Retrieves the next page of results.</p> |
| <p class="toc_element"> |
| <code><a href="#rate">rate(id, rating, x__xgafv=None)</a></code></p> |
| <p class="firstline">Adds a like or dislike rating to a video or removes a rating from a video.</p> |
| <p class="toc_element"> |
| <code><a href="#reportAbuse">reportAbuse(body=None, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Report abuse for a video.</p> |
| <p class="toc_element"> |
| <code><a href="#update">update(part, body=None, onBehalfOfContentOwner=None, x__xgafv=None)</a></code></p> |
| <p class="firstline">Updates an existing resource.</p> |
| <h3>Method Details</h3> |
| <div class="method"> |
| <code class="details" id="delete">delete(id, onBehalfOfContentOwner=None, x__xgafv=None)</code> |
| <pre>Deletes a resource. |
| |
| Args: |
| id: string, A parameter (required) |
| onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwner</strong></code> 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 actual |
| CMS account that the user authenticates with must be linked to the |
| specified YouTube content owner. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="getRating">getRating(id, onBehalfOfContentOwner=None, x__xgafv=None)</code> |
| <pre>Retrieves the ratings that the authorized user gave to a list of specified |
| videos. |
| |
| Args: |
| id: string, A parameter (required) (repeated) |
| onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwner</strong></code> 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. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "items": [ # A list of ratings that match the request criteria. |
| { # Basic details about rating of a video. |
| "videoId": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "rating": "A String", # Rating of a video. |
| }, |
| ], |
| "etag": "A String", # Etag of this resource. |
| "kind": "youtube#videoGetRatingResponse", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#videoGetRatingResponse"</code>. |
| "eventId": "A String", # Serialized EventId of the request which produced this response. |
| "visitorId": "A String", # The <code>visitorId</code> identifies the visitor. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="insert">insert(part, body=None, autoLevels=None, stabilize=None, onBehalfOfContentOwnerChannel=None, notifySubscribers=None, onBehalfOfContentOwner=None, x__xgafv=None, media_body=None, media_mime_type=None)</code> |
| <pre>Inserts a new resource into this collection. |
| |
| Args: |
| part: string, The <code><strong>part</strong></code> parameter serves two purposes in |
| this operation. It identifies the properties that the write operation will |
| set as well as the properties that the API response will |
| include.<br/><br/>Note that not all parts contain properties that can be |
| set when inserting or updating a video. For example, the |
| <code>statistics</code> object encapsulates statistics that YouTube |
| calculates for a video and does not contain values that you can set or |
| modify. If the parameter value specifies a <code>part</code> that does not |
| contain mutable values, that <code>part</code> will still be included in |
| the API response. (required) (repeated) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # A <code><strong>video</strong></code> resource represents a YouTube video. |
| "recordingDetails": { # Recording information associated with the video. # The <code>recordingDetails</code> object encapsulates information about the |
| # location, date and address where the video was recorded. |
| "locationDescription": "A String", # The text description of the location where the video was recorded. |
| "recordingDate": "A String", # The date and time when the video was recorded. The value is specified in <a |
| # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # (<code>YYYY-MM-DDThh:mm:ss.sssZ</code>) format. |
| "location": { # Geographical coordinates of a point, in WGS84. # The geolocation information associated with the video. |
| "latitude": 3.14, # Latitude in degrees. |
| "longitude": 3.14, # Longitude in degrees. |
| "altitude": 3.14, # Altitude above the reference ellipsoid, in meters. |
| }, |
| }, |
| "contentDetails": { # Details about the content of a YouTube Video. # The <code>contentDetails</code> object contains information about the video |
| # content, including the length of the video and its aspect ratio. |
| "dimension": "A String", # The value of <code>dimension</code> indicates whether the video is |
| # available in 3D or in 2D. |
| "caption": "A String", # The value of <code>captions</code> indicates whether the video |
| # has captions or not. |
| "duration": "A String", # The length of the video. The tag value is an <a |
| # href="//en.wikipedia.org/wiki/ISO_8601#Durations">ISO 8601</a> duration in |
| # the format <code>PT#M#S</code>, in which the letters <code>PT</code> |
| # indicate that the value specifies a period of time, and the letters |
| # <code>M</code> and <code>S</code> refer to length in minutes and seconds, |
| # respectively. The <code>#</code> characters preceding the <code>M</code> |
| # and <code>S</code> letters are both integers that specify the number of |
| # minutes (or seconds) of the video. For example, a value of |
| # <code>PT15M51S</code> indicates that the video is 15 minutes and 51 seconds |
| # long. |
| "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom |
| # thumbnail image for the video. |
| # This property is only visible to the video uploader. |
| "regionRestriction": { # DEPRECATED Region restriction of the video. # The <code>regionRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. The object will contain |
| # either the <code>contentDetails.regionRestriction.allowed</code> property |
| # or the <code>contentDetails.regionRestriction.blocked</code> property. |
| "allowed": [ # A list of region codes that identify countries where the video is |
| # viewable. If this property is present and a country is not listed |
| # in its value, then the video is blocked from appearing in that |
| # country. If this property is present and contains an empty list, |
| # the video is blocked in all countries. |
| "A String", |
| ], |
| "blocked": [ # A list of region codes that identify countries where the video is |
| # blocked. If this property is present and a country is not listed in |
| # its value, then the video is viewable in that country. If this |
| # property is present and contains an empty list, the video is |
| # viewable in all countries. |
| "A String", |
| ], |
| }, |
| "licensedContent": True or False, # The value of <code>is_license_content</code> indicates whether the video is |
| # licensed content. |
| "countryRestriction": { # Rights management policy for YouTube resources. # The <code>countryRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| "definition": "A String", # The value of <code>definition</code> indicates whether the video is |
| # available in high definition or only in standard definition. |
| "contentRating": { # Ratings schemes. The country-specific ratings are mostly for # Specifies the ratings that the video received under various rating schemes. |
| # movies and shows. |
| # LINT.IfChange |
| "cscfRating": "A String", # The video's rating from Luxembourg's Commission de surveillance |
| # de la classification des films (CSCF). |
| "icaaRating": "A String", # The video's Instituto de la Cinematograf&iacute;a y de las Artes |
| # Audiovisuales (ICAA - Spain) rating. |
| "mpaaRating": "A String", # The video's Motion Picture Association of America (MPAA) rating. |
| "nbcRating": "A String", # The video's rating from the Maldives National Bureau of Classification. |
| "oflcRating": "A String", # The video's Office of Film and Literature Classification |
| # (OFLC - New Zealand) rating. |
| "fcbmRating": "A String", # The video's rating from Malaysia's Film Censorship Board. |
| "fpbRating": "A String", # The video's rating from South Africa's Film and Publication Board. |
| "djctqRating": "A String", # The video's Departamento de Justi&ccedil;a, Classifica&ccedil;&atilde;o, |
| # Qualifica&ccedil;&atilde;o e T&iacute;tulos (DJCQT - Brazil) rating. |
| "mpaatRating": "A String", # The rating system for trailer, DVD, and Ad in the US. See |
| # http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html. |
| "chfilmRating": "A String", # The video's rating in Switzerland. |
| "nmcRating": "A String", # The National Media Council ratings system for United Arab Emirates. |
| "acbRating": "A String", # The video's Australian Classification Board (ACB) or Australian |
| # Communications and Media Authority (ACMA) rating. ACMA ratings are used |
| # to classify children's television programming. |
| "mccaaRating": "A String", # The video's rating from Malta's Film Age-Classification Board. |
| "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attivit&agrave; |
| # Culturali e del Turismo (Italy). |
| "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian French-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/frenchsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "moctwRating": "A String", # The video's rating from Taiwan's Ministry of Culture |
| # (&#25991;&#21270;&#37096;). |
| "nkclvRating": "A String", # The video's rating from the Nacion&atilde;lais Kino centrs (National Film |
| # Centre of Latvia). |
| "csaRating": "A String", # The video's rating from France's Conseil sup&eacute;rieur de |
| # l’audiovisuel, which rates broadcast content. |
| "rteRating": "A String", # The video's rating from Ireland's Raidi&oacute; Teilif&iacute;s |
| # &Eacute;ireann. |
| "ifcoRating": "A String", # The video's Irish Film Classification Office (IFCO - Ireland) rating. |
| # See the <a |
| # href="http://www.ifco.ie/website/ifco/ifcoweb.nsf/web/classcatintro">IFCO</a> |
| # website for more information. |
| "cceRating": "A String", # The video's rating from Portugal's Comiss&atilde;o de |
| # Classifica&ccedil;&atilde;o de Espect&acute;culos. |
| "ecbmctRating": "A String", # Rating system in Turkey - Evaluation and Classification Board of the |
| # Ministry of Culture and Tourism |
| "egfilmRating": "A String", # The video's rating in Egypt. |
| "eirinRating": "A String", # The video's Eirin (&#26144;&#20523;) rating. |
| # Eirin is the Japanese rating system. |
| "ilfilmRating": "A String", # The video's rating in Israel. |
| "bmukkRating": "A String", # The video's rating from the Austrian Board of Media Classification |
| # (Bundesministerium f&uuml;r Unterricht, Kunst und Kultur). |
| "fpbRatingReasons": [ # Reasons that explain why the video received its FPB (South Africa) rating. |
| "A String", |
| ], |
| "tvpgRating": "A String", # The video's TV Parental Guidelines (TVPG) rating. |
| "smaisRating": "A String", # The video's rating in Iceland. |
| "mekuRating": "A String", # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti |
| # (National Audiovisual Institute). |
| "smsaRating": "A String", # The video's rating from Statens medier&aring;d (Sweden's National Media |
| # Council). |
| "lsfRating": "A String", # The video's rating from Indonesia's Lembaga Sensor Film. |
| "nbcplRating": "A String", # The video's rating in Poland. |
| "ytRating": "A String", # A rating that YouTube uses to identify age-restricted content. |
| "czfilmRating": "A String", # The video's rating in the Czech Republic. |
| "kijkwijzerRating": "A String", # The video's NICAM/Kijkwijzer rating from the Nederlands Instituut |
| # voor de Classificatie van Audiovisuele Media (Netherlands). |
| "rcnofRating": "A String", # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating |
| # Committee of the National Office of Film. |
| "cncRating": "A String", # Rating system in France - Commission de classification cinematographique |
| "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating. |
| "cicfRating": "A String", # The video's rating from the Commission de Contr&ocirc;le des Films |
| # (Belgium). |
| "fcoRating": "A String", # The video's rating from Hong Kong's Office for Film, Newspaper |
| # and Article Administration. |
| "catvRating": "A String", # Rating system for Canadian TV - Canadian TV Classification System |
| # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian English-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/englishsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "resorteviolenciaRating": "A String", # The video's rating in Venezuela. |
| "russiaRating": "A String", # The video's National Film Registry of the Russian Federation |
| # (MKRF - Russia) rating. |
| "kfcbRating": "A String", # The video's rating from the Kenya Film Classification Board. |
| "bfvcRating": "A String", # The video's rating from Thailand's Board of Film and Video Censors. |
| "medietilsynetRating": "A String", # The video's rating from Medietilsynet, the Norwegian Media Authority. |
| "djctqRatingReasons": [ # Reasons that explain why the video received its DJCQT (Brazil) rating. |
| "A String", |
| ], |
| "agcomRating": "A String", # The video's rating from Italy's Autorit&agrave; per le Garanzie nelle |
| # Comunicazioni (AGCOM). |
| "pefilmRating": "A String", # The video's rating in Peru. |
| "mcstRating": "A String", # The video's rating system for Vietnam - MCST |
| "mccypRating": "A String", # The video's rating from the Danish Film Institute's (Det Danske |
| # Filminstitut) Media Council for Children and Young People. |
| "grfilmRating": "A String", # The video's rating in Greece. |
| "bbfcRating": "A String", # The video's British Board of Film Classification (BBFC) rating. |
| "menaMpaaRating": "A String", # The rating system for MENA countries, a clone of MPAA. It is needed to |
| # prevent titles go live w/o additional QC check, since some of them can be |
| # inappropriate for the countries at all. See b/33408548 for more details. |
| "chvrsRating": "A String", # The video's Canadian Home Video Rating System (CHVRS) rating. |
| "mdaRating": "A String", # The video's rating from Singapore's Media Development Authority (MDA) and, |
| # specifically, it's Board of Film Censors (BFC). |
| "kmrbRating": "A String", # The video's Korea Media Rating Board |
| # (&#50689;&#49345;&#47932;&#46321;&#44553;&#50948;&#50896;&#54924;) rating. |
| # The KMRB rates videos in South Korea. |
| "nfrcRating": "A String", # The video's rating from the <a href="http://www.nfc.bg/">Bulgarian |
| # National Film Center</a>. |
| "fmocRating": "A String", # <span class="deprecated">This property has been deprecated. Use the |
| # <code><a |
| # href="#contentDetails.contentRating.cncRating">contentDetails.contentRating.cncRating</a></code> |
| # instead.</span> |
| "eefilmRating": "A String", # The video's rating in Estonia. |
| "cnaRating": "A String", # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI |
| # (CNA). |
| "fskRating": "A String", # The video's Freiwillige Selbstkontrolle der Filmwirtschaft |
| # (FSK - Germany) rating. |
| "skfilmRating": "A String", # The video's rating in Slovakia. |
| "incaaRating": "A String", # The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales - |
| # Argentina) rating. |
| "mocRating": "A String", # The video's Ministerio de Cultura (Colombia) rating. |
| "rtcRating": "A String", # The video's General Directorate of Radio, Television and Cinematography |
| # (Mexico) rating. |
| "anatelRating": "A String", # The video's Anatel (Asociaci&oacute;n Nacional de Televisi&oacute;n) |
| # rating for Chilean television. |
| "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and |
| # Classification Board (Philippines). |
| "cccRating": "A String", # The video's Consejo de Calificaci&oacute;n Cinematogr&aacute;fica (Chile) |
| # rating. |
| "nfvcbRating": "A String", # The video's rating from Nigeria's National Film and Video Censors Board. |
| }, |
| "projection": "A String", # Specifies the projection format of the video. |
| }, |
| "projectDetails": { # Project specific details about the content of a YouTube Video. # The <code>projectDetails</code> object contains information about the |
| # project specific video metadata. |
| "tags": [ # A list of project tags associated with the video during the upload. |
| "A String", |
| ], |
| }, |
| "id": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "localizations": { # The <code>localizations</code> object contains localized versions of the |
| # basic details about the video, such as its title and description. |
| "a_key": { # Localized versions of certain video properties (e.g. title). |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| }, |
| "monetizationDetails": { # Details about monetization of a YouTube Video. # The <code>monetizationDetails</code> object encapsulates information |
| # about the monetization status of the video. |
| "access": { # Rights management policy for YouTube resources. # The value of <code>access</code> indicates whether the video can be |
| # monetized or not. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| }, |
| "status": { # Basic details about a video category, such as its localized title. # The <code>status</code> object contains information about the video's |
| # uploading, processing, and privacy statuses. |
| # Next Id: 17 |
| "failureReason": "A String", # This value explains why a video failed to upload. This property is |
| # only present if the <code>uploadStatus</code> property indicates that |
| # the upload failed. |
| "privacyStatus": "A String", # The video's privacy status. |
| "selfDeclaredMadeForKids": True or False, |
| "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This |
| # property is only present if the <code>uploadStatus</code> property |
| # indicates that the upload was rejected. |
| "embeddable": True or False, # This value indicates if the video can be embedded on another website. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set |
| # only if the privacy status of the video is private. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| "madeForKids": True or False, |
| "license": "A String", # The video's license. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page |
| # can be viewed by everyone. Note that the view count, likes, etc will still |
| # be visible if this is disabled. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "uploadStatus": "A String", # The status of the uploaded video. |
| }, |
| "statistics": { # Statistics about the video, such as the number of times the video was viewed # The <code>statistics</code> object contains statistics about the video. |
| # or liked. |
| "likeCount": "A String", # The number of users who have indicated that they liked the video by |
| # giving it a positive rating. |
| "dislikeCount": "A String", # The number of users who have indicated that they disliked the video by |
| # giving it a negative rating. |
| "favoriteCount": "A String", # The number of users who currently have the video marked as a favorite |
| # video. |
| "commentCount": "A String", # The number of comments for the video. |
| "viewCount": "A String", # The number of times the video has been viewed. |
| }, |
| "snippet": { # Basic details about a video, including title, description, uploader, # The <code>snippet</code> object contains basic details about the video, |
| # such as its title, description, and category. |
| # thumbnails and category. |
| "localized": { # Localized versions of certain video properties (e.g. title). # Localized snippet selected with the hl parameter. If no such localization |
| # exists, this field is populated with the default snippet. (Read-only) |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| "tags": [ # A list of keyword tags associated with the video. Tags may contain spaces. |
| "A String", |
| ], |
| "defaultLanguage": "A String", # The language of the videos's default snippet. |
| "title": "A String", # The video's title. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "liveBroadcastContent": "A String", # Indicates if the video is an upcoming/active live broadcast. |
| # Or it's "none" if the video is not an upcoming/active live broadcast. |
| "description": "A String", # The video's description. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "channelTitle": "A String", # Channel title for the channel that the video belongs to. |
| "defaultAudioLanguage": "A String", # The <code>default_audio_language</code> property specifies the language |
| # spoken in the video's default audio track. |
| "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel that the |
| # video was uploaded to. |
| "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the video. For each object in the |
| # map, the key is the name of the thumbnail image, and the value is an object |
| # that contains other information about the thumbnail. |
| "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| }, |
| "categoryId": "A String", # The YouTube <a href="/youtube/v3/docs/videoCategories/list">video |
| # category</a> associated with the video. |
| "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "processingDetails": { # Describes processing status and progress and availability of some other Video # The <code>processingDetails</code> object encapsulates information about |
| # YouTube's progress in processing the uploaded video file. The properties |
| # in the object identify the current processing status and an estimate of |
| # the time remaining until YouTube finishes processing the video. This part |
| # also indicates whether different types of data or content, such as file |
| # details or thumbnail images, are available for the video.<br><br> |
| # The <code>processingProgress</code> object is designed to be polled so |
| # that the video uploaded can track the progress that YouTube has made in |
| # processing the uploaded video file. This data can only be retrieved by |
| # the video owner. |
| # resource parts. |
| "fileDetailsAvailability": "A String", # This value indicates whether file details are available for the uploaded |
| # video. You can retrieve a video's file details by requesting the |
| # <code>fileDetails</code> part in your <code>videos.list()</code> request. |
| "processingFailureReason": "A String", # The reason that YouTube failed to process the video. This property will |
| # only have a value if the <code>processingStatus</code> |
| # property's value is <code>failed</code>. |
| "editorSuggestionsAvailability": "A String", # This value indicates whether video editing suggestions, which might |
| # improve video quality or the playback experience, are available for |
| # the video. You can retrieve these suggestions by requesting the |
| # <code>suggestions</code> part in your <code>videos.list()</code> request. |
| "tagSuggestionsAvailability": "A String", # This value indicates whether keyword (tag) suggestions are available for |
| # the video. Tags can be added to a video's metadata to make it easier for |
| # other users to find the video. You can retrieve these suggestions by |
| # requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingProgress": { # Video processing progress and completion time estimate. # The <code>processingProgress</code> object contains information about the |
| # progress YouTube has made in processing the video. The values are really |
| # only relevant if the video's processing status is <code>processing</code>. |
| "timeLeftMs": "A String", # An estimate of the amount of time, in millseconds, that YouTube needs |
| # to finish processing the video. |
| "partsProcessed": "A String", # The number of parts of the video that YouTube has already processed. |
| # You can estimate the percentage of the video that YouTube has already |
| # processed by calculating:<br> |
| # <code>100 * parts_processed / parts_total</code><br><br> |
| # Note that since the estimated number of parts could increase without |
| # a corresponding increase in the number of parts that have already been |
| # processed, it is possible that the calculated progress could |
| # periodically decrease while YouTube processes a video. |
| "partsTotal": "A String", # An estimate of the total number of parts that need to be processed |
| # for the video. The number may be updated with more precise estimates |
| # while YouTube processes the video. |
| }, |
| "thumbnailsAvailability": "A String", # This value indicates whether thumbnail images have been generated for |
| # the video. |
| "processingIssuesAvailability": "A String", # This value indicates whether the video processing engine has generated |
| # suggestions that might improve YouTube's ability to process the |
| # the video, warnings that explain video processing problems, or |
| # errors that cause video processing problems. You can retrieve these |
| # suggestions by requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingStatus": "A String", # The video's processing status. This value indicates whether YouTube was |
| # able to process the video or if the video is still being processed. |
| }, |
| "etag": "A String", # Etag of this resource. |
| "player": { # Player to be used for a video playback. # The <code>player</code> object contains information that you would use to |
| # play the video in an embedded player. |
| "embedWidth": "A String", # The embed width |
| "embedHeight": "A String", |
| "embedHtml": "A String", # An <code>&lt;iframe&gt;</code> tag that embeds a player that will |
| # play the video. |
| }, |
| "liveStreamingDetails": { # Details about the live streaming metadata. # The <code>liveStreamingDetails</code> object contains metadata about a live |
| # video broadcast. The object will only be present in a <code>video</code> |
| # resource if the video is an upcoming, live, or completed live broadcast. |
| "activeLiveChatId": "A String", # The ID of the currently active live chat attached to this video. This |
| # field is filled only if the video is a currently live broadcast that has |
| # live chat. Once the broadcast transitions to complete this field will be |
| # removed and the live chat closed down. For persistent broadcasts that live |
| # chat id will no longer be tied to this video but rather to the new video |
| # being displayed at the persistent page. |
| "concurrentViewers": "A String", # The number of viewers currently watching the broadcast. The property and |
| # its value will be present if the broadcast has current viewers and the |
| # broadcast owner has not hidden the viewcount for the video. Note that |
| # YouTube stops tracking the number of concurrent viewers for a broadcast |
| # when the broadcast ends. So, this property would not identify the number |
| # of viewers watching an archived video of a live broadcast that already |
| # ended. |
| "scheduledEndTime": "A String", # The time that the broadcast is scheduled to end. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. If the value is empty or |
| # the property is not present, then the broadcast is scheduled to continue |
| # indefinitely. |
| "actualStartTime": "A String", # The time that the broadcast actually started. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast begins. |
| "actualEndTime": "A String", # The time that the broadcast actually ended. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast is over. |
| "scheduledStartTime": "A String", # The time that the broadcast is scheduled to begin. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "topicDetails": { # Freebase topic information related to the video. # The <code>topicDetails</code> object encapsulates information about <a |
| # href="http://www.freebase.com">Freebase</a> topics associated with the |
| # video. |
| "topicCategories": [ # A list of Wikipedia URLs that provide a high-level description of the |
| # video's content. |
| "A String", |
| ], |
| "relevantTopicIds": [ # Similar to topic_id, except that these topics are merely relevant to the |
| # video. These are topics that may be mentioned in, or appear in the video. |
| # You can retrieve information about each topic using <a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| "topicIds": [ # A list of Freebase topic IDs that are centrally associated with the video. |
| # These are topics that are centrally featured in the video, and it can be |
| # said that the video is mainly about each of these. You can retrieve |
| # information about each topic using the < a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| }, |
| "fileDetails": { # Describes original video file properties, including technical details about # The <code>fileDetails</code> object encapsulates information about the |
| # video file that was uploaded to YouTube, including the file's resolution, |
| # duration, audio and video codecs, stream bitrates, and more. This data can |
| # only be retrieved by the video owner. |
| # audio and video streams, but also metadata information like content length, |
| # digitization time, or geotagging information. |
| "fileName": "A String", # The uploaded file's name. This field is present whether a video file or |
| # another type of file was uploaded. |
| "videoStreams": [ # A list of video streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about a video stream. |
| { # Information about a video stream. |
| "bitrateBps": "A String", # The video stream's bitrate, in bits per second. |
| "heightPixels": 42, # The encoded video content's height in pixels. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value is |
| # a four-letter vendor code. |
| "rotation": "A String", # The amount that YouTube needs to rotate the original source content |
| # to properly display the video. |
| "codec": "A String", # The video codec that the stream uses. |
| "frameRateFps": 3.14, # The video stream's frame rate, in frames per second. |
| "aspectRatio": 3.14, # The video content's display aspect ratio, which specifies the aspect |
| # ratio in which the video should be displayed. |
| "widthPixels": 42, # The encoded video content's width in pixels. You can calculate the |
| # video's encoding aspect ratio as |
| # <code>width_pixels</code>&nbsp;/&nbsp;<code>height_pixels</code>. |
| }, |
| ], |
| "audioStreams": [ # A list of audio streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about an audio stream. |
| { # Information about an audio stream. |
| "codec": "A String", # The audio codec that the stream uses. |
| "channelCount": 42, # The number of audio channels that the stream contains. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value |
| # is a four-letter vendor code. |
| "bitrateBps": "A String", # The audio stream's bitrate, in bits per second. |
| }, |
| ], |
| "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits |
| # per second. |
| "durationMs": "A String", # The length of the uploaded video in milliseconds. |
| "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing |
| # engine. Currently, YouTube only processes video files, but this field |
| # is present whether a video file or another type of file was uploaded. |
| "fileSize": "A String", # The uploaded file's size in bytes. This field is present whether |
| # a video file or another type of file was uploaded. |
| "container": "A String", # The uploaded video file's container format. |
| "creationTime": "A String", # The date and time when the uploaded video file was created. The value is |
| # specified in <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. Currently, the following ISO 8601 formats are supported: |
| # <ul> |
| # <li>Date only: <code>YYYY-MM-DD</code></li> |
| # <li>Naive time: <code>YYYY-MM-DDTHH:MM:SS</code></li> |
| # <li>Time with timezone: <code>YYYY-MM-DDTHH:MM:SS+HH:MM</code></li> |
| # </ul> |
| }, |
| "ageGating": { # Age restriction details related to a video. This data can only be retrieved |
| # by the video owner. |
| "videoGameRating": "A String", # Video game rating, if any. |
| "alcoholContent": True or False, # Indicates whether or not the video has alcoholic beverage content. Only |
| # users of legal purchasing age in a particular country, as identified by |
| # ICAP, can view the content. |
| "restricted": True or False, # Age-restricted trailers. For redband trailers and adult-rated video-games. |
| # Only users aged 18+ can view the content. The the field is |
| # <code>true</code> the content is restricted to viewers aged 18+. Otherwise |
| # The field won't be present. |
| }, |
| "kind": "youtube#video", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#video"</code>. |
| "suggestions": { # Specifies suggestions on how to improve video content, # The <code>suggestions</code> object encapsulates suggestions that identify |
| # opportunities to improve the video quality or the metadata for the uploaded |
| # video. This data can only be retrieved by the video owner. |
| # including encoding hints, tag suggestions, and editor suggestions. |
| "processingHints": [ # A list of suggestions that may improve YouTube's ability to process the |
| # video. |
| "A String", |
| ], |
| "tagSuggestions": [ # A list of keyword tags that could be added to the video's metadata to |
| # increase the likelihood that users will locate your video when searching |
| # or browsing on YouTube. |
| { # A single tag suggestion with it's relevance information. |
| "tag": "A String", # The keyword tag suggested for the video. |
| "categoryRestricts": [ # A set of video categories for which the tag is relevant. You can use this |
| # information to display appropriate tag suggestions based on the video |
| # category that the video uploader associates with the video. By default, |
| # tag suggestions are relevant for all categories if there are no restricts |
| # defined for the keyword. |
| "A String", |
| ], |
| }, |
| ], |
| "processingErrors": [ # A list of errors that will prevent YouTube from successfully processing |
| # the uploaded video video. These errors indicate that, regardless of the |
| # video's current <a href="#processingProgress.processingStatus">processing |
| # status</a>, eventually, that status will almost certainly be |
| # <code>failed</code>. |
| "A String", |
| ], |
| "editorSuggestions": [ # A list of video editing operations that might improve the video quality |
| # or playback experience of the uploaded video. |
| "A String", |
| ], |
| "processingWarnings": [ # A list of reasons why YouTube may have difficulty transcoding the |
| # uploaded video or that might result in an erroneous transcoding. |
| # These warnings are generated before YouTube actually processes the |
| # uploaded video file. In addition, they identify issues that are unlikely |
| # to cause the video processing to fail but that might cause problems |
| # such as sync issues, video artifacts, or a missing audio track. |
| "A String", |
| ], |
| }, |
| } |
| |
| autoLevels: boolean, Should auto-levels be applied to the upload. |
| stabilize: boolean, Should stabilize be applied to the upload. |
| onBehalfOfContentOwnerChannel: string, This parameter can only be used in a properly <a |
| href="/youtube/v3/guides/authentication">authorized request</a>. |
| <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwnerChannel</strong></code> parameter |
| specifies the YouTube channel ID of the channel to which a video is being |
| added. This parameter is required when a request specifies a value for the |
| <code>onBehalfOfContentOwner</code> parameter, and it can only be used in |
| conjunction with that parameter. In addition, the request must be |
| authorized using a CMS account that is linked to the content owner that the |
| <code>onBehalfOfContentOwner</code> parameter specifies. Finally, the |
| channel that the <code>onBehalfOfContentOwnerChannel</code> parameter value |
| specifies must be linked to the content owner that the |
| <code>onBehalfOfContentOwner</code> parameter specifies.<br><br>This |
| parameter is intended for YouTube content partners that own and manage many |
| different YouTube channels. It allows content owners to authenticate once |
| and perform actions on behalf of the channel specified in the parameter |
| value, without having to provide authentication credentials for each |
| separate channel. |
| notifySubscribers: boolean, Notify the channel subscribers about the new video. As default, the |
| notification is enabled. |
| onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwner</strong></code> 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. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| media_body: string, The filename of the media request body, or an instance of a MediaUpload object. |
| media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object. |
| |
| Returns: |
| An object of the form: |
| |
| { # A <code><strong>video</strong></code> resource represents a YouTube video. |
| "recordingDetails": { # Recording information associated with the video. # The <code>recordingDetails</code> object encapsulates information about the |
| # location, date and address where the video was recorded. |
| "locationDescription": "A String", # The text description of the location where the video was recorded. |
| "recordingDate": "A String", # The date and time when the video was recorded. The value is specified in <a |
| # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # (<code>YYYY-MM-DDThh:mm:ss.sssZ</code>) format. |
| "location": { # Geographical coordinates of a point, in WGS84. # The geolocation information associated with the video. |
| "latitude": 3.14, # Latitude in degrees. |
| "longitude": 3.14, # Longitude in degrees. |
| "altitude": 3.14, # Altitude above the reference ellipsoid, in meters. |
| }, |
| }, |
| "contentDetails": { # Details about the content of a YouTube Video. # The <code>contentDetails</code> object contains information about the video |
| # content, including the length of the video and its aspect ratio. |
| "dimension": "A String", # The value of <code>dimension</code> indicates whether the video is |
| # available in 3D or in 2D. |
| "caption": "A String", # The value of <code>captions</code> indicates whether the video |
| # has captions or not. |
| "duration": "A String", # The length of the video. The tag value is an <a |
| # href="//en.wikipedia.org/wiki/ISO_8601#Durations">ISO 8601</a> duration in |
| # the format <code>PT#M#S</code>, in which the letters <code>PT</code> |
| # indicate that the value specifies a period of time, and the letters |
| # <code>M</code> and <code>S</code> refer to length in minutes and seconds, |
| # respectively. The <code>#</code> characters preceding the <code>M</code> |
| # and <code>S</code> letters are both integers that specify the number of |
| # minutes (or seconds) of the video. For example, a value of |
| # <code>PT15M51S</code> indicates that the video is 15 minutes and 51 seconds |
| # long. |
| "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom |
| # thumbnail image for the video. |
| # This property is only visible to the video uploader. |
| "regionRestriction": { # DEPRECATED Region restriction of the video. # The <code>regionRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. The object will contain |
| # either the <code>contentDetails.regionRestriction.allowed</code> property |
| # or the <code>contentDetails.regionRestriction.blocked</code> property. |
| "allowed": [ # A list of region codes that identify countries where the video is |
| # viewable. If this property is present and a country is not listed |
| # in its value, then the video is blocked from appearing in that |
| # country. If this property is present and contains an empty list, |
| # the video is blocked in all countries. |
| "A String", |
| ], |
| "blocked": [ # A list of region codes that identify countries where the video is |
| # blocked. If this property is present and a country is not listed in |
| # its value, then the video is viewable in that country. If this |
| # property is present and contains an empty list, the video is |
| # viewable in all countries. |
| "A String", |
| ], |
| }, |
| "licensedContent": True or False, # The value of <code>is_license_content</code> indicates whether the video is |
| # licensed content. |
| "countryRestriction": { # Rights management policy for YouTube resources. # The <code>countryRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| "definition": "A String", # The value of <code>definition</code> indicates whether the video is |
| # available in high definition or only in standard definition. |
| "contentRating": { # Ratings schemes. The country-specific ratings are mostly for # Specifies the ratings that the video received under various rating schemes. |
| # movies and shows. |
| # LINT.IfChange |
| "cscfRating": "A String", # The video's rating from Luxembourg's Commission de surveillance |
| # de la classification des films (CSCF). |
| "icaaRating": "A String", # The video's Instituto de la Cinematograf&iacute;a y de las Artes |
| # Audiovisuales (ICAA - Spain) rating. |
| "mpaaRating": "A String", # The video's Motion Picture Association of America (MPAA) rating. |
| "nbcRating": "A String", # The video's rating from the Maldives National Bureau of Classification. |
| "oflcRating": "A String", # The video's Office of Film and Literature Classification |
| # (OFLC - New Zealand) rating. |
| "fcbmRating": "A String", # The video's rating from Malaysia's Film Censorship Board. |
| "fpbRating": "A String", # The video's rating from South Africa's Film and Publication Board. |
| "djctqRating": "A String", # The video's Departamento de Justi&ccedil;a, Classifica&ccedil;&atilde;o, |
| # Qualifica&ccedil;&atilde;o e T&iacute;tulos (DJCQT - Brazil) rating. |
| "mpaatRating": "A String", # The rating system for trailer, DVD, and Ad in the US. See |
| # http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html. |
| "chfilmRating": "A String", # The video's rating in Switzerland. |
| "nmcRating": "A String", # The National Media Council ratings system for United Arab Emirates. |
| "acbRating": "A String", # The video's Australian Classification Board (ACB) or Australian |
| # Communications and Media Authority (ACMA) rating. ACMA ratings are used |
| # to classify children's television programming. |
| "mccaaRating": "A String", # The video's rating from Malta's Film Age-Classification Board. |
| "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attivit&agrave; |
| # Culturali e del Turismo (Italy). |
| "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian French-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/frenchsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "moctwRating": "A String", # The video's rating from Taiwan's Ministry of Culture |
| # (&#25991;&#21270;&#37096;). |
| "nkclvRating": "A String", # The video's rating from the Nacion&atilde;lais Kino centrs (National Film |
| # Centre of Latvia). |
| "csaRating": "A String", # The video's rating from France's Conseil sup&eacute;rieur de |
| # l’audiovisuel, which rates broadcast content. |
| "rteRating": "A String", # The video's rating from Ireland's Raidi&oacute; Teilif&iacute;s |
| # &Eacute;ireann. |
| "ifcoRating": "A String", # The video's Irish Film Classification Office (IFCO - Ireland) rating. |
| # See the <a |
| # href="http://www.ifco.ie/website/ifco/ifcoweb.nsf/web/classcatintro">IFCO</a> |
| # website for more information. |
| "cceRating": "A String", # The video's rating from Portugal's Comiss&atilde;o de |
| # Classifica&ccedil;&atilde;o de Espect&acute;culos. |
| "ecbmctRating": "A String", # Rating system in Turkey - Evaluation and Classification Board of the |
| # Ministry of Culture and Tourism |
| "egfilmRating": "A String", # The video's rating in Egypt. |
| "eirinRating": "A String", # The video's Eirin (&#26144;&#20523;) rating. |
| # Eirin is the Japanese rating system. |
| "ilfilmRating": "A String", # The video's rating in Israel. |
| "bmukkRating": "A String", # The video's rating from the Austrian Board of Media Classification |
| # (Bundesministerium f&uuml;r Unterricht, Kunst und Kultur). |
| "fpbRatingReasons": [ # Reasons that explain why the video received its FPB (South Africa) rating. |
| "A String", |
| ], |
| "tvpgRating": "A String", # The video's TV Parental Guidelines (TVPG) rating. |
| "smaisRating": "A String", # The video's rating in Iceland. |
| "mekuRating": "A String", # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti |
| # (National Audiovisual Institute). |
| "smsaRating": "A String", # The video's rating from Statens medier&aring;d (Sweden's National Media |
| # Council). |
| "lsfRating": "A String", # The video's rating from Indonesia's Lembaga Sensor Film. |
| "nbcplRating": "A String", # The video's rating in Poland. |
| "ytRating": "A String", # A rating that YouTube uses to identify age-restricted content. |
| "czfilmRating": "A String", # The video's rating in the Czech Republic. |
| "kijkwijzerRating": "A String", # The video's NICAM/Kijkwijzer rating from the Nederlands Instituut |
| # voor de Classificatie van Audiovisuele Media (Netherlands). |
| "rcnofRating": "A String", # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating |
| # Committee of the National Office of Film. |
| "cncRating": "A String", # Rating system in France - Commission de classification cinematographique |
| "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating. |
| "cicfRating": "A String", # The video's rating from the Commission de Contr&ocirc;le des Films |
| # (Belgium). |
| "fcoRating": "A String", # The video's rating from Hong Kong's Office for Film, Newspaper |
| # and Article Administration. |
| "catvRating": "A String", # Rating system for Canadian TV - Canadian TV Classification System |
| # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian English-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/englishsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "resorteviolenciaRating": "A String", # The video's rating in Venezuela. |
| "russiaRating": "A String", # The video's National Film Registry of the Russian Federation |
| # (MKRF - Russia) rating. |
| "kfcbRating": "A String", # The video's rating from the Kenya Film Classification Board. |
| "bfvcRating": "A String", # The video's rating from Thailand's Board of Film and Video Censors. |
| "medietilsynetRating": "A String", # The video's rating from Medietilsynet, the Norwegian Media Authority. |
| "djctqRatingReasons": [ # Reasons that explain why the video received its DJCQT (Brazil) rating. |
| "A String", |
| ], |
| "agcomRating": "A String", # The video's rating from Italy's Autorit&agrave; per le Garanzie nelle |
| # Comunicazioni (AGCOM). |
| "pefilmRating": "A String", # The video's rating in Peru. |
| "mcstRating": "A String", # The video's rating system for Vietnam - MCST |
| "mccypRating": "A String", # The video's rating from the Danish Film Institute's (Det Danske |
| # Filminstitut) Media Council for Children and Young People. |
| "grfilmRating": "A String", # The video's rating in Greece. |
| "bbfcRating": "A String", # The video's British Board of Film Classification (BBFC) rating. |
| "menaMpaaRating": "A String", # The rating system for MENA countries, a clone of MPAA. It is needed to |
| # prevent titles go live w/o additional QC check, since some of them can be |
| # inappropriate for the countries at all. See b/33408548 for more details. |
| "chvrsRating": "A String", # The video's Canadian Home Video Rating System (CHVRS) rating. |
| "mdaRating": "A String", # The video's rating from Singapore's Media Development Authority (MDA) and, |
| # specifically, it's Board of Film Censors (BFC). |
| "kmrbRating": "A String", # The video's Korea Media Rating Board |
| # (&#50689;&#49345;&#47932;&#46321;&#44553;&#50948;&#50896;&#54924;) rating. |
| # The KMRB rates videos in South Korea. |
| "nfrcRating": "A String", # The video's rating from the <a href="http://www.nfc.bg/">Bulgarian |
| # National Film Center</a>. |
| "fmocRating": "A String", # <span class="deprecated">This property has been deprecated. Use the |
| # <code><a |
| # href="#contentDetails.contentRating.cncRating">contentDetails.contentRating.cncRating</a></code> |
| # instead.</span> |
| "eefilmRating": "A String", # The video's rating in Estonia. |
| "cnaRating": "A String", # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI |
| # (CNA). |
| "fskRating": "A String", # The video's Freiwillige Selbstkontrolle der Filmwirtschaft |
| # (FSK - Germany) rating. |
| "skfilmRating": "A String", # The video's rating in Slovakia. |
| "incaaRating": "A String", # The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales - |
| # Argentina) rating. |
| "mocRating": "A String", # The video's Ministerio de Cultura (Colombia) rating. |
| "rtcRating": "A String", # The video's General Directorate of Radio, Television and Cinematography |
| # (Mexico) rating. |
| "anatelRating": "A String", # The video's Anatel (Asociaci&oacute;n Nacional de Televisi&oacute;n) |
| # rating for Chilean television. |
| "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and |
| # Classification Board (Philippines). |
| "cccRating": "A String", # The video's Consejo de Calificaci&oacute;n Cinematogr&aacute;fica (Chile) |
| # rating. |
| "nfvcbRating": "A String", # The video's rating from Nigeria's National Film and Video Censors Board. |
| }, |
| "projection": "A String", # Specifies the projection format of the video. |
| }, |
| "projectDetails": { # Project specific details about the content of a YouTube Video. # The <code>projectDetails</code> object contains information about the |
| # project specific video metadata. |
| "tags": [ # A list of project tags associated with the video during the upload. |
| "A String", |
| ], |
| }, |
| "id": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "localizations": { # The <code>localizations</code> object contains localized versions of the |
| # basic details about the video, such as its title and description. |
| "a_key": { # Localized versions of certain video properties (e.g. title). |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| }, |
| "monetizationDetails": { # Details about monetization of a YouTube Video. # The <code>monetizationDetails</code> object encapsulates information |
| # about the monetization status of the video. |
| "access": { # Rights management policy for YouTube resources. # The value of <code>access</code> indicates whether the video can be |
| # monetized or not. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| }, |
| "status": { # Basic details about a video category, such as its localized title. # The <code>status</code> object contains information about the video's |
| # uploading, processing, and privacy statuses. |
| # Next Id: 17 |
| "failureReason": "A String", # This value explains why a video failed to upload. This property is |
| # only present if the <code>uploadStatus</code> property indicates that |
| # the upload failed. |
| "privacyStatus": "A String", # The video's privacy status. |
| "selfDeclaredMadeForKids": True or False, |
| "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This |
| # property is only present if the <code>uploadStatus</code> property |
| # indicates that the upload was rejected. |
| "embeddable": True or False, # This value indicates if the video can be embedded on another website. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set |
| # only if the privacy status of the video is private. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| "madeForKids": True or False, |
| "license": "A String", # The video's license. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page |
| # can be viewed by everyone. Note that the view count, likes, etc will still |
| # be visible if this is disabled. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "uploadStatus": "A String", # The status of the uploaded video. |
| }, |
| "statistics": { # Statistics about the video, such as the number of times the video was viewed # The <code>statistics</code> object contains statistics about the video. |
| # or liked. |
| "likeCount": "A String", # The number of users who have indicated that they liked the video by |
| # giving it a positive rating. |
| "dislikeCount": "A String", # The number of users who have indicated that they disliked the video by |
| # giving it a negative rating. |
| "favoriteCount": "A String", # The number of users who currently have the video marked as a favorite |
| # video. |
| "commentCount": "A String", # The number of comments for the video. |
| "viewCount": "A String", # The number of times the video has been viewed. |
| }, |
| "snippet": { # Basic details about a video, including title, description, uploader, # The <code>snippet</code> object contains basic details about the video, |
| # such as its title, description, and category. |
| # thumbnails and category. |
| "localized": { # Localized versions of certain video properties (e.g. title). # Localized snippet selected with the hl parameter. If no such localization |
| # exists, this field is populated with the default snippet. (Read-only) |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| "tags": [ # A list of keyword tags associated with the video. Tags may contain spaces. |
| "A String", |
| ], |
| "defaultLanguage": "A String", # The language of the videos's default snippet. |
| "title": "A String", # The video's title. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "liveBroadcastContent": "A String", # Indicates if the video is an upcoming/active live broadcast. |
| # Or it's "none" if the video is not an upcoming/active live broadcast. |
| "description": "A String", # The video's description. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "channelTitle": "A String", # Channel title for the channel that the video belongs to. |
| "defaultAudioLanguage": "A String", # The <code>default_audio_language</code> property specifies the language |
| # spoken in the video's default audio track. |
| "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel that the |
| # video was uploaded to. |
| "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the video. For each object in the |
| # map, the key is the name of the thumbnail image, and the value is an object |
| # that contains other information about the thumbnail. |
| "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| }, |
| "categoryId": "A String", # The YouTube <a href="/youtube/v3/docs/videoCategories/list">video |
| # category</a> associated with the video. |
| "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "processingDetails": { # Describes processing status and progress and availability of some other Video # The <code>processingDetails</code> object encapsulates information about |
| # YouTube's progress in processing the uploaded video file. The properties |
| # in the object identify the current processing status and an estimate of |
| # the time remaining until YouTube finishes processing the video. This part |
| # also indicates whether different types of data or content, such as file |
| # details or thumbnail images, are available for the video.<br><br> |
| # The <code>processingProgress</code> object is designed to be polled so |
| # that the video uploaded can track the progress that YouTube has made in |
| # processing the uploaded video file. This data can only be retrieved by |
| # the video owner. |
| # resource parts. |
| "fileDetailsAvailability": "A String", # This value indicates whether file details are available for the uploaded |
| # video. You can retrieve a video's file details by requesting the |
| # <code>fileDetails</code> part in your <code>videos.list()</code> request. |
| "processingFailureReason": "A String", # The reason that YouTube failed to process the video. This property will |
| # only have a value if the <code>processingStatus</code> |
| # property's value is <code>failed</code>. |
| "editorSuggestionsAvailability": "A String", # This value indicates whether video editing suggestions, which might |
| # improve video quality or the playback experience, are available for |
| # the video. You can retrieve these suggestions by requesting the |
| # <code>suggestions</code> part in your <code>videos.list()</code> request. |
| "tagSuggestionsAvailability": "A String", # This value indicates whether keyword (tag) suggestions are available for |
| # the video. Tags can be added to a video's metadata to make it easier for |
| # other users to find the video. You can retrieve these suggestions by |
| # requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingProgress": { # Video processing progress and completion time estimate. # The <code>processingProgress</code> object contains information about the |
| # progress YouTube has made in processing the video. The values are really |
| # only relevant if the video's processing status is <code>processing</code>. |
| "timeLeftMs": "A String", # An estimate of the amount of time, in millseconds, that YouTube needs |
| # to finish processing the video. |
| "partsProcessed": "A String", # The number of parts of the video that YouTube has already processed. |
| # You can estimate the percentage of the video that YouTube has already |
| # processed by calculating:<br> |
| # <code>100 * parts_processed / parts_total</code><br><br> |
| # Note that since the estimated number of parts could increase without |
| # a corresponding increase in the number of parts that have already been |
| # processed, it is possible that the calculated progress could |
| # periodically decrease while YouTube processes a video. |
| "partsTotal": "A String", # An estimate of the total number of parts that need to be processed |
| # for the video. The number may be updated with more precise estimates |
| # while YouTube processes the video. |
| }, |
| "thumbnailsAvailability": "A String", # This value indicates whether thumbnail images have been generated for |
| # the video. |
| "processingIssuesAvailability": "A String", # This value indicates whether the video processing engine has generated |
| # suggestions that might improve YouTube's ability to process the |
| # the video, warnings that explain video processing problems, or |
| # errors that cause video processing problems. You can retrieve these |
| # suggestions by requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingStatus": "A String", # The video's processing status. This value indicates whether YouTube was |
| # able to process the video or if the video is still being processed. |
| }, |
| "etag": "A String", # Etag of this resource. |
| "player": { # Player to be used for a video playback. # The <code>player</code> object contains information that you would use to |
| # play the video in an embedded player. |
| "embedWidth": "A String", # The embed width |
| "embedHeight": "A String", |
| "embedHtml": "A String", # An <code>&lt;iframe&gt;</code> tag that embeds a player that will |
| # play the video. |
| }, |
| "liveStreamingDetails": { # Details about the live streaming metadata. # The <code>liveStreamingDetails</code> object contains metadata about a live |
| # video broadcast. The object will only be present in a <code>video</code> |
| # resource if the video is an upcoming, live, or completed live broadcast. |
| "activeLiveChatId": "A String", # The ID of the currently active live chat attached to this video. This |
| # field is filled only if the video is a currently live broadcast that has |
| # live chat. Once the broadcast transitions to complete this field will be |
| # removed and the live chat closed down. For persistent broadcasts that live |
| # chat id will no longer be tied to this video but rather to the new video |
| # being displayed at the persistent page. |
| "concurrentViewers": "A String", # The number of viewers currently watching the broadcast. The property and |
| # its value will be present if the broadcast has current viewers and the |
| # broadcast owner has not hidden the viewcount for the video. Note that |
| # YouTube stops tracking the number of concurrent viewers for a broadcast |
| # when the broadcast ends. So, this property would not identify the number |
| # of viewers watching an archived video of a live broadcast that already |
| # ended. |
| "scheduledEndTime": "A String", # The time that the broadcast is scheduled to end. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. If the value is empty or |
| # the property is not present, then the broadcast is scheduled to continue |
| # indefinitely. |
| "actualStartTime": "A String", # The time that the broadcast actually started. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast begins. |
| "actualEndTime": "A String", # The time that the broadcast actually ended. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast is over. |
| "scheduledStartTime": "A String", # The time that the broadcast is scheduled to begin. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "topicDetails": { # Freebase topic information related to the video. # The <code>topicDetails</code> object encapsulates information about <a |
| # href="http://www.freebase.com">Freebase</a> topics associated with the |
| # video. |
| "topicCategories": [ # A list of Wikipedia URLs that provide a high-level description of the |
| # video's content. |
| "A String", |
| ], |
| "relevantTopicIds": [ # Similar to topic_id, except that these topics are merely relevant to the |
| # video. These are topics that may be mentioned in, or appear in the video. |
| # You can retrieve information about each topic using <a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| "topicIds": [ # A list of Freebase topic IDs that are centrally associated with the video. |
| # These are topics that are centrally featured in the video, and it can be |
| # said that the video is mainly about each of these. You can retrieve |
| # information about each topic using the < a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| }, |
| "fileDetails": { # Describes original video file properties, including technical details about # The <code>fileDetails</code> object encapsulates information about the |
| # video file that was uploaded to YouTube, including the file's resolution, |
| # duration, audio and video codecs, stream bitrates, and more. This data can |
| # only be retrieved by the video owner. |
| # audio and video streams, but also metadata information like content length, |
| # digitization time, or geotagging information. |
| "fileName": "A String", # The uploaded file's name. This field is present whether a video file or |
| # another type of file was uploaded. |
| "videoStreams": [ # A list of video streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about a video stream. |
| { # Information about a video stream. |
| "bitrateBps": "A String", # The video stream's bitrate, in bits per second. |
| "heightPixels": 42, # The encoded video content's height in pixels. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value is |
| # a four-letter vendor code. |
| "rotation": "A String", # The amount that YouTube needs to rotate the original source content |
| # to properly display the video. |
| "codec": "A String", # The video codec that the stream uses. |
| "frameRateFps": 3.14, # The video stream's frame rate, in frames per second. |
| "aspectRatio": 3.14, # The video content's display aspect ratio, which specifies the aspect |
| # ratio in which the video should be displayed. |
| "widthPixels": 42, # The encoded video content's width in pixels. You can calculate the |
| # video's encoding aspect ratio as |
| # <code>width_pixels</code>&nbsp;/&nbsp;<code>height_pixels</code>. |
| }, |
| ], |
| "audioStreams": [ # A list of audio streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about an audio stream. |
| { # Information about an audio stream. |
| "codec": "A String", # The audio codec that the stream uses. |
| "channelCount": 42, # The number of audio channels that the stream contains. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value |
| # is a four-letter vendor code. |
| "bitrateBps": "A String", # The audio stream's bitrate, in bits per second. |
| }, |
| ], |
| "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits |
| # per second. |
| "durationMs": "A String", # The length of the uploaded video in milliseconds. |
| "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing |
| # engine. Currently, YouTube only processes video files, but this field |
| # is present whether a video file or another type of file was uploaded. |
| "fileSize": "A String", # The uploaded file's size in bytes. This field is present whether |
| # a video file or another type of file was uploaded. |
| "container": "A String", # The uploaded video file's container format. |
| "creationTime": "A String", # The date and time when the uploaded video file was created. The value is |
| # specified in <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. Currently, the following ISO 8601 formats are supported: |
| # <ul> |
| # <li>Date only: <code>YYYY-MM-DD</code></li> |
| # <li>Naive time: <code>YYYY-MM-DDTHH:MM:SS</code></li> |
| # <li>Time with timezone: <code>YYYY-MM-DDTHH:MM:SS+HH:MM</code></li> |
| # </ul> |
| }, |
| "ageGating": { # Age restriction details related to a video. This data can only be retrieved |
| # by the video owner. |
| "videoGameRating": "A String", # Video game rating, if any. |
| "alcoholContent": True or False, # Indicates whether or not the video has alcoholic beverage content. Only |
| # users of legal purchasing age in a particular country, as identified by |
| # ICAP, can view the content. |
| "restricted": True or False, # Age-restricted trailers. For redband trailers and adult-rated video-games. |
| # Only users aged 18+ can view the content. The the field is |
| # <code>true</code> the content is restricted to viewers aged 18+. Otherwise |
| # The field won't be present. |
| }, |
| "kind": "youtube#video", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#video"</code>. |
| "suggestions": { # Specifies suggestions on how to improve video content, # The <code>suggestions</code> object encapsulates suggestions that identify |
| # opportunities to improve the video quality or the metadata for the uploaded |
| # video. This data can only be retrieved by the video owner. |
| # including encoding hints, tag suggestions, and editor suggestions. |
| "processingHints": [ # A list of suggestions that may improve YouTube's ability to process the |
| # video. |
| "A String", |
| ], |
| "tagSuggestions": [ # A list of keyword tags that could be added to the video's metadata to |
| # increase the likelihood that users will locate your video when searching |
| # or browsing on YouTube. |
| { # A single tag suggestion with it's relevance information. |
| "tag": "A String", # The keyword tag suggested for the video. |
| "categoryRestricts": [ # A set of video categories for which the tag is relevant. You can use this |
| # information to display appropriate tag suggestions based on the video |
| # category that the video uploader associates with the video. By default, |
| # tag suggestions are relevant for all categories if there are no restricts |
| # defined for the keyword. |
| "A String", |
| ], |
| }, |
| ], |
| "processingErrors": [ # A list of errors that will prevent YouTube from successfully processing |
| # the uploaded video video. These errors indicate that, regardless of the |
| # video's current <a href="#processingProgress.processingStatus">processing |
| # status</a>, eventually, that status will almost certainly be |
| # <code>failed</code>. |
| "A String", |
| ], |
| "editorSuggestions": [ # A list of video editing operations that might improve the video quality |
| # or playback experience of the uploaded video. |
| "A String", |
| ], |
| "processingWarnings": [ # A list of reasons why YouTube may have difficulty transcoding the |
| # uploaded video or that might result in an erroneous transcoding. |
| # These warnings are generated before YouTube actually processes the |
| # uploaded video file. In addition, they identify issues that are unlikely |
| # to cause the video processing to fail but that might cause problems |
| # such as sync issues, video artifacts, or a missing audio track. |
| "A String", |
| ], |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list">list(part, myRating=None, locale=None, chart=None, videoCategoryId=None, maxWidth=None, regionCode=None, maxHeight=None, id=None, maxResults=None, onBehalfOfContentOwner=None, hl=None, pageToken=None, x__xgafv=None)</code> |
| <pre>Retrieves a list of resources, possibly filtered. |
| |
| Args: |
| part: string, The <code><strong>part</strong></code> parameter specifies a |
| comma-separated list of one or more <code>video</code> resource properties |
| that the API response will include.<br><br>If the parameter identifies a |
| property that contains child properties, the child properties will be |
| included in the response. For example, in a <code>video</code> resource, |
| the <code>snippet</code> property contains the <code>channelId</code>, |
| <code>title</code>, <code>description</code>, <code>tags</code>, and |
| <code>categoryId</code> properties. As such, if you set |
| <code><strong>part=snippet</strong></code>, the API response will contain |
| all of those properties. (required) (repeated) |
| myRating: string, Return videos liked/disliked by the authenticated user. |
| Does not support RateType.RATED_TYPE_NONE. |
| locale: string, A parameter |
| chart: string, Return the videos that are in the specified chart. |
| videoCategoryId: string, Use chart that is specific to the specified video category |
| maxWidth: integer, Return the player with maximum height specified in |
| regionCode: string, Use a chart that is specific to the specified region |
| maxHeight: integer, A parameter |
| id: string, Return videos with the given ids. (repeated) |
| maxResults: integer, The <code><strong>maxResults</strong></code> parameter specifies the |
| maximum number of items that should be returned in the result |
| set.<br><br><strong>Note:</strong> This parameter is supported for use in |
| conjunction with the <code><a href="#myRating">myRating</a></code> and |
| <code><a href="#chart">chart</a></code> parameters, but it is not supported |
| for use in conjunction with the <code><a href="#id">id</a></code> |
| parameter. |
| onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwner</strong></code> 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. |
| hl: string, Stands for "host language". Specifies the localization language of the |
| metadata to be filled into snippet.localized. The field is filled with the |
| default metadata if there is no localization in the specified language. |
| The parameter value must be a language code included in the list returned |
| by the i18nLanguages.list method (e.g. en_US, es_MX). |
| pageToken: string, The <code><strong>pageToken</strong></code> parameter identifies a specific |
| page in the result set that should be returned. In an API response, the |
| <code>nextPageToken</code> and <code>prevPageToken</code> properties |
| identify other pages that could be retrieved.<br><br><strong>Note:</strong> |
| This parameter is supported for use in conjunction with the <code><a |
| href="#myRating">myRating</a></code> and <code><a |
| href="#chart">chart</a></code> parameters, but it is not supported for use |
| in conjunction with the <code><a href="#id">id</a></code> parameter. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "tokenPagination": { # Stub token pagination template to suppress results. |
| }, |
| "etag": "A String", # Etag of this resource. |
| "nextPageToken": "A String", # The token that can be used as the value of the <code>pageToken</code> |
| # parameter to retrieve the next page in the result set. |
| "eventId": "A String", # Serialized EventId of the request which produced this response. |
| "kind": "youtube#videoListResponse", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#videoListResponse"</code>. |
| "items": [ |
| { # A <code><strong>video</strong></code> resource represents a YouTube video. |
| "recordingDetails": { # Recording information associated with the video. # The <code>recordingDetails</code> object encapsulates information about the |
| # location, date and address where the video was recorded. |
| "locationDescription": "A String", # The text description of the location where the video was recorded. |
| "recordingDate": "A String", # The date and time when the video was recorded. The value is specified in <a |
| # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # (<code>YYYY-MM-DDThh:mm:ss.sssZ</code>) format. |
| "location": { # Geographical coordinates of a point, in WGS84. # The geolocation information associated with the video. |
| "latitude": 3.14, # Latitude in degrees. |
| "longitude": 3.14, # Longitude in degrees. |
| "altitude": 3.14, # Altitude above the reference ellipsoid, in meters. |
| }, |
| }, |
| "contentDetails": { # Details about the content of a YouTube Video. # The <code>contentDetails</code> object contains information about the video |
| # content, including the length of the video and its aspect ratio. |
| "dimension": "A String", # The value of <code>dimension</code> indicates whether the video is |
| # available in 3D or in 2D. |
| "caption": "A String", # The value of <code>captions</code> indicates whether the video |
| # has captions or not. |
| "duration": "A String", # The length of the video. The tag value is an <a |
| # href="//en.wikipedia.org/wiki/ISO_8601#Durations">ISO 8601</a> duration in |
| # the format <code>PT#M#S</code>, in which the letters <code>PT</code> |
| # indicate that the value specifies a period of time, and the letters |
| # <code>M</code> and <code>S</code> refer to length in minutes and seconds, |
| # respectively. The <code>#</code> characters preceding the <code>M</code> |
| # and <code>S</code> letters are both integers that specify the number of |
| # minutes (or seconds) of the video. For example, a value of |
| # <code>PT15M51S</code> indicates that the video is 15 minutes and 51 seconds |
| # long. |
| "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom |
| # thumbnail image for the video. |
| # This property is only visible to the video uploader. |
| "regionRestriction": { # DEPRECATED Region restriction of the video. # The <code>regionRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. The object will contain |
| # either the <code>contentDetails.regionRestriction.allowed</code> property |
| # or the <code>contentDetails.regionRestriction.blocked</code> property. |
| "allowed": [ # A list of region codes that identify countries where the video is |
| # viewable. If this property is present and a country is not listed |
| # in its value, then the video is blocked from appearing in that |
| # country. If this property is present and contains an empty list, |
| # the video is blocked in all countries. |
| "A String", |
| ], |
| "blocked": [ # A list of region codes that identify countries where the video is |
| # blocked. If this property is present and a country is not listed in |
| # its value, then the video is viewable in that country. If this |
| # property is present and contains an empty list, the video is |
| # viewable in all countries. |
| "A String", |
| ], |
| }, |
| "licensedContent": True or False, # The value of <code>is_license_content</code> indicates whether the video is |
| # licensed content. |
| "countryRestriction": { # Rights management policy for YouTube resources. # The <code>countryRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| "definition": "A String", # The value of <code>definition</code> indicates whether the video is |
| # available in high definition or only in standard definition. |
| "contentRating": { # Ratings schemes. The country-specific ratings are mostly for # Specifies the ratings that the video received under various rating schemes. |
| # movies and shows. |
| # LINT.IfChange |
| "cscfRating": "A String", # The video's rating from Luxembourg's Commission de surveillance |
| # de la classification des films (CSCF). |
| "icaaRating": "A String", # The video's Instituto de la Cinematograf&iacute;a y de las Artes |
| # Audiovisuales (ICAA - Spain) rating. |
| "mpaaRating": "A String", # The video's Motion Picture Association of America (MPAA) rating. |
| "nbcRating": "A String", # The video's rating from the Maldives National Bureau of Classification. |
| "oflcRating": "A String", # The video's Office of Film and Literature Classification |
| # (OFLC - New Zealand) rating. |
| "fcbmRating": "A String", # The video's rating from Malaysia's Film Censorship Board. |
| "fpbRating": "A String", # The video's rating from South Africa's Film and Publication Board. |
| "djctqRating": "A String", # The video's Departamento de Justi&ccedil;a, Classifica&ccedil;&atilde;o, |
| # Qualifica&ccedil;&atilde;o e T&iacute;tulos (DJCQT - Brazil) rating. |
| "mpaatRating": "A String", # The rating system for trailer, DVD, and Ad in the US. See |
| # http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html. |
| "chfilmRating": "A String", # The video's rating in Switzerland. |
| "nmcRating": "A String", # The National Media Council ratings system for United Arab Emirates. |
| "acbRating": "A String", # The video's Australian Classification Board (ACB) or Australian |
| # Communications and Media Authority (ACMA) rating. ACMA ratings are used |
| # to classify children's television programming. |
| "mccaaRating": "A String", # The video's rating from Malta's Film Age-Classification Board. |
| "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attivit&agrave; |
| # Culturali e del Turismo (Italy). |
| "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian French-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/frenchsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "moctwRating": "A String", # The video's rating from Taiwan's Ministry of Culture |
| # (&#25991;&#21270;&#37096;). |
| "nkclvRating": "A String", # The video's rating from the Nacion&atilde;lais Kino centrs (National Film |
| # Centre of Latvia). |
| "csaRating": "A String", # The video's rating from France's Conseil sup&eacute;rieur de |
| # l’audiovisuel, which rates broadcast content. |
| "rteRating": "A String", # The video's rating from Ireland's Raidi&oacute; Teilif&iacute;s |
| # &Eacute;ireann. |
| "ifcoRating": "A String", # The video's Irish Film Classification Office (IFCO - Ireland) rating. |
| # See the <a |
| # href="http://www.ifco.ie/website/ifco/ifcoweb.nsf/web/classcatintro">IFCO</a> |
| # website for more information. |
| "cceRating": "A String", # The video's rating from Portugal's Comiss&atilde;o de |
| # Classifica&ccedil;&atilde;o de Espect&acute;culos. |
| "ecbmctRating": "A String", # Rating system in Turkey - Evaluation and Classification Board of the |
| # Ministry of Culture and Tourism |
| "egfilmRating": "A String", # The video's rating in Egypt. |
| "eirinRating": "A String", # The video's Eirin (&#26144;&#20523;) rating. |
| # Eirin is the Japanese rating system. |
| "ilfilmRating": "A String", # The video's rating in Israel. |
| "bmukkRating": "A String", # The video's rating from the Austrian Board of Media Classification |
| # (Bundesministerium f&uuml;r Unterricht, Kunst und Kultur). |
| "fpbRatingReasons": [ # Reasons that explain why the video received its FPB (South Africa) rating. |
| "A String", |
| ], |
| "tvpgRating": "A String", # The video's TV Parental Guidelines (TVPG) rating. |
| "smaisRating": "A String", # The video's rating in Iceland. |
| "mekuRating": "A String", # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti |
| # (National Audiovisual Institute). |
| "smsaRating": "A String", # The video's rating from Statens medier&aring;d (Sweden's National Media |
| # Council). |
| "lsfRating": "A String", # The video's rating from Indonesia's Lembaga Sensor Film. |
| "nbcplRating": "A String", # The video's rating in Poland. |
| "ytRating": "A String", # A rating that YouTube uses to identify age-restricted content. |
| "czfilmRating": "A String", # The video's rating in the Czech Republic. |
| "kijkwijzerRating": "A String", # The video's NICAM/Kijkwijzer rating from the Nederlands Instituut |
| # voor de Classificatie van Audiovisuele Media (Netherlands). |
| "rcnofRating": "A String", # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating |
| # Committee of the National Office of Film. |
| "cncRating": "A String", # Rating system in France - Commission de classification cinematographique |
| "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating. |
| "cicfRating": "A String", # The video's rating from the Commission de Contr&ocirc;le des Films |
| # (Belgium). |
| "fcoRating": "A String", # The video's rating from Hong Kong's Office for Film, Newspaper |
| # and Article Administration. |
| "catvRating": "A String", # Rating system for Canadian TV - Canadian TV Classification System |
| # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian English-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/englishsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "resorteviolenciaRating": "A String", # The video's rating in Venezuela. |
| "russiaRating": "A String", # The video's National Film Registry of the Russian Federation |
| # (MKRF - Russia) rating. |
| "kfcbRating": "A String", # The video's rating from the Kenya Film Classification Board. |
| "bfvcRating": "A String", # The video's rating from Thailand's Board of Film and Video Censors. |
| "medietilsynetRating": "A String", # The video's rating from Medietilsynet, the Norwegian Media Authority. |
| "djctqRatingReasons": [ # Reasons that explain why the video received its DJCQT (Brazil) rating. |
| "A String", |
| ], |
| "agcomRating": "A String", # The video's rating from Italy's Autorit&agrave; per le Garanzie nelle |
| # Comunicazioni (AGCOM). |
| "pefilmRating": "A String", # The video's rating in Peru. |
| "mcstRating": "A String", # The video's rating system for Vietnam - MCST |
| "mccypRating": "A String", # The video's rating from the Danish Film Institute's (Det Danske |
| # Filminstitut) Media Council for Children and Young People. |
| "grfilmRating": "A String", # The video's rating in Greece. |
| "bbfcRating": "A String", # The video's British Board of Film Classification (BBFC) rating. |
| "menaMpaaRating": "A String", # The rating system for MENA countries, a clone of MPAA. It is needed to |
| # prevent titles go live w/o additional QC check, since some of them can be |
| # inappropriate for the countries at all. See b/33408548 for more details. |
| "chvrsRating": "A String", # The video's Canadian Home Video Rating System (CHVRS) rating. |
| "mdaRating": "A String", # The video's rating from Singapore's Media Development Authority (MDA) and, |
| # specifically, it's Board of Film Censors (BFC). |
| "kmrbRating": "A String", # The video's Korea Media Rating Board |
| # (&#50689;&#49345;&#47932;&#46321;&#44553;&#50948;&#50896;&#54924;) rating. |
| # The KMRB rates videos in South Korea. |
| "nfrcRating": "A String", # The video's rating from the <a href="http://www.nfc.bg/">Bulgarian |
| # National Film Center</a>. |
| "fmocRating": "A String", # <span class="deprecated">This property has been deprecated. Use the |
| # <code><a |
| # href="#contentDetails.contentRating.cncRating">contentDetails.contentRating.cncRating</a></code> |
| # instead.</span> |
| "eefilmRating": "A String", # The video's rating in Estonia. |
| "cnaRating": "A String", # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI |
| # (CNA). |
| "fskRating": "A String", # The video's Freiwillige Selbstkontrolle der Filmwirtschaft |
| # (FSK - Germany) rating. |
| "skfilmRating": "A String", # The video's rating in Slovakia. |
| "incaaRating": "A String", # The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales - |
| # Argentina) rating. |
| "mocRating": "A String", # The video's Ministerio de Cultura (Colombia) rating. |
| "rtcRating": "A String", # The video's General Directorate of Radio, Television and Cinematography |
| # (Mexico) rating. |
| "anatelRating": "A String", # The video's Anatel (Asociaci&oacute;n Nacional de Televisi&oacute;n) |
| # rating for Chilean television. |
| "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and |
| # Classification Board (Philippines). |
| "cccRating": "A String", # The video's Consejo de Calificaci&oacute;n Cinematogr&aacute;fica (Chile) |
| # rating. |
| "nfvcbRating": "A String", # The video's rating from Nigeria's National Film and Video Censors Board. |
| }, |
| "projection": "A String", # Specifies the projection format of the video. |
| }, |
| "projectDetails": { # Project specific details about the content of a YouTube Video. # The <code>projectDetails</code> object contains information about the |
| # project specific video metadata. |
| "tags": [ # A list of project tags associated with the video during the upload. |
| "A String", |
| ], |
| }, |
| "id": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "localizations": { # The <code>localizations</code> object contains localized versions of the |
| # basic details about the video, such as its title and description. |
| "a_key": { # Localized versions of certain video properties (e.g. title). |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| }, |
| "monetizationDetails": { # Details about monetization of a YouTube Video. # The <code>monetizationDetails</code> object encapsulates information |
| # about the monetization status of the video. |
| "access": { # Rights management policy for YouTube resources. # The value of <code>access</code> indicates whether the video can be |
| # monetized or not. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| }, |
| "status": { # Basic details about a video category, such as its localized title. # The <code>status</code> object contains information about the video's |
| # uploading, processing, and privacy statuses. |
| # Next Id: 17 |
| "failureReason": "A String", # This value explains why a video failed to upload. This property is |
| # only present if the <code>uploadStatus</code> property indicates that |
| # the upload failed. |
| "privacyStatus": "A String", # The video's privacy status. |
| "selfDeclaredMadeForKids": True or False, |
| "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This |
| # property is only present if the <code>uploadStatus</code> property |
| # indicates that the upload was rejected. |
| "embeddable": True or False, # This value indicates if the video can be embedded on another website. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set |
| # only if the privacy status of the video is private. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| "madeForKids": True or False, |
| "license": "A String", # The video's license. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page |
| # can be viewed by everyone. Note that the view count, likes, etc will still |
| # be visible if this is disabled. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "uploadStatus": "A String", # The status of the uploaded video. |
| }, |
| "statistics": { # Statistics about the video, such as the number of times the video was viewed # The <code>statistics</code> object contains statistics about the video. |
| # or liked. |
| "likeCount": "A String", # The number of users who have indicated that they liked the video by |
| # giving it a positive rating. |
| "dislikeCount": "A String", # The number of users who have indicated that they disliked the video by |
| # giving it a negative rating. |
| "favoriteCount": "A String", # The number of users who currently have the video marked as a favorite |
| # video. |
| "commentCount": "A String", # The number of comments for the video. |
| "viewCount": "A String", # The number of times the video has been viewed. |
| }, |
| "snippet": { # Basic details about a video, including title, description, uploader, # The <code>snippet</code> object contains basic details about the video, |
| # such as its title, description, and category. |
| # thumbnails and category. |
| "localized": { # Localized versions of certain video properties (e.g. title). # Localized snippet selected with the hl parameter. If no such localization |
| # exists, this field is populated with the default snippet. (Read-only) |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| "tags": [ # A list of keyword tags associated with the video. Tags may contain spaces. |
| "A String", |
| ], |
| "defaultLanguage": "A String", # The language of the videos's default snippet. |
| "title": "A String", # The video's title. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "liveBroadcastContent": "A String", # Indicates if the video is an upcoming/active live broadcast. |
| # Or it's "none" if the video is not an upcoming/active live broadcast. |
| "description": "A String", # The video's description. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "channelTitle": "A String", # Channel title for the channel that the video belongs to. |
| "defaultAudioLanguage": "A String", # The <code>default_audio_language</code> property specifies the language |
| # spoken in the video's default audio track. |
| "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel that the |
| # video was uploaded to. |
| "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the video. For each object in the |
| # map, the key is the name of the thumbnail image, and the value is an object |
| # that contains other information about the thumbnail. |
| "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| }, |
| "categoryId": "A String", # The YouTube <a href="/youtube/v3/docs/videoCategories/list">video |
| # category</a> associated with the video. |
| "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "processingDetails": { # Describes processing status and progress and availability of some other Video # The <code>processingDetails</code> object encapsulates information about |
| # YouTube's progress in processing the uploaded video file. The properties |
| # in the object identify the current processing status and an estimate of |
| # the time remaining until YouTube finishes processing the video. This part |
| # also indicates whether different types of data or content, such as file |
| # details or thumbnail images, are available for the video.<br><br> |
| # The <code>processingProgress</code> object is designed to be polled so |
| # that the video uploaded can track the progress that YouTube has made in |
| # processing the uploaded video file. This data can only be retrieved by |
| # the video owner. |
| # resource parts. |
| "fileDetailsAvailability": "A String", # This value indicates whether file details are available for the uploaded |
| # video. You can retrieve a video's file details by requesting the |
| # <code>fileDetails</code> part in your <code>videos.list()</code> request. |
| "processingFailureReason": "A String", # The reason that YouTube failed to process the video. This property will |
| # only have a value if the <code>processingStatus</code> |
| # property's value is <code>failed</code>. |
| "editorSuggestionsAvailability": "A String", # This value indicates whether video editing suggestions, which might |
| # improve video quality or the playback experience, are available for |
| # the video. You can retrieve these suggestions by requesting the |
| # <code>suggestions</code> part in your <code>videos.list()</code> request. |
| "tagSuggestionsAvailability": "A String", # This value indicates whether keyword (tag) suggestions are available for |
| # the video. Tags can be added to a video's metadata to make it easier for |
| # other users to find the video. You can retrieve these suggestions by |
| # requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingProgress": { # Video processing progress and completion time estimate. # The <code>processingProgress</code> object contains information about the |
| # progress YouTube has made in processing the video. The values are really |
| # only relevant if the video's processing status is <code>processing</code>. |
| "timeLeftMs": "A String", # An estimate of the amount of time, in millseconds, that YouTube needs |
| # to finish processing the video. |
| "partsProcessed": "A String", # The number of parts of the video that YouTube has already processed. |
| # You can estimate the percentage of the video that YouTube has already |
| # processed by calculating:<br> |
| # <code>100 * parts_processed / parts_total</code><br><br> |
| # Note that since the estimated number of parts could increase without |
| # a corresponding increase in the number of parts that have already been |
| # processed, it is possible that the calculated progress could |
| # periodically decrease while YouTube processes a video. |
| "partsTotal": "A String", # An estimate of the total number of parts that need to be processed |
| # for the video. The number may be updated with more precise estimates |
| # while YouTube processes the video. |
| }, |
| "thumbnailsAvailability": "A String", # This value indicates whether thumbnail images have been generated for |
| # the video. |
| "processingIssuesAvailability": "A String", # This value indicates whether the video processing engine has generated |
| # suggestions that might improve YouTube's ability to process the |
| # the video, warnings that explain video processing problems, or |
| # errors that cause video processing problems. You can retrieve these |
| # suggestions by requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingStatus": "A String", # The video's processing status. This value indicates whether YouTube was |
| # able to process the video or if the video is still being processed. |
| }, |
| "etag": "A String", # Etag of this resource. |
| "player": { # Player to be used for a video playback. # The <code>player</code> object contains information that you would use to |
| # play the video in an embedded player. |
| "embedWidth": "A String", # The embed width |
| "embedHeight": "A String", |
| "embedHtml": "A String", # An <code>&lt;iframe&gt;</code> tag that embeds a player that will |
| # play the video. |
| }, |
| "liveStreamingDetails": { # Details about the live streaming metadata. # The <code>liveStreamingDetails</code> object contains metadata about a live |
| # video broadcast. The object will only be present in a <code>video</code> |
| # resource if the video is an upcoming, live, or completed live broadcast. |
| "activeLiveChatId": "A String", # The ID of the currently active live chat attached to this video. This |
| # field is filled only if the video is a currently live broadcast that has |
| # live chat. Once the broadcast transitions to complete this field will be |
| # removed and the live chat closed down. For persistent broadcasts that live |
| # chat id will no longer be tied to this video but rather to the new video |
| # being displayed at the persistent page. |
| "concurrentViewers": "A String", # The number of viewers currently watching the broadcast. The property and |
| # its value will be present if the broadcast has current viewers and the |
| # broadcast owner has not hidden the viewcount for the video. Note that |
| # YouTube stops tracking the number of concurrent viewers for a broadcast |
| # when the broadcast ends. So, this property would not identify the number |
| # of viewers watching an archived video of a live broadcast that already |
| # ended. |
| "scheduledEndTime": "A String", # The time that the broadcast is scheduled to end. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. If the value is empty or |
| # the property is not present, then the broadcast is scheduled to continue |
| # indefinitely. |
| "actualStartTime": "A String", # The time that the broadcast actually started. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast begins. |
| "actualEndTime": "A String", # The time that the broadcast actually ended. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast is over. |
| "scheduledStartTime": "A String", # The time that the broadcast is scheduled to begin. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "topicDetails": { # Freebase topic information related to the video. # The <code>topicDetails</code> object encapsulates information about <a |
| # href="http://www.freebase.com">Freebase</a> topics associated with the |
| # video. |
| "topicCategories": [ # A list of Wikipedia URLs that provide a high-level description of the |
| # video's content. |
| "A String", |
| ], |
| "relevantTopicIds": [ # Similar to topic_id, except that these topics are merely relevant to the |
| # video. These are topics that may be mentioned in, or appear in the video. |
| # You can retrieve information about each topic using <a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| "topicIds": [ # A list of Freebase topic IDs that are centrally associated with the video. |
| # These are topics that are centrally featured in the video, and it can be |
| # said that the video is mainly about each of these. You can retrieve |
| # information about each topic using the < a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| }, |
| "fileDetails": { # Describes original video file properties, including technical details about # The <code>fileDetails</code> object encapsulates information about the |
| # video file that was uploaded to YouTube, including the file's resolution, |
| # duration, audio and video codecs, stream bitrates, and more. This data can |
| # only be retrieved by the video owner. |
| # audio and video streams, but also metadata information like content length, |
| # digitization time, or geotagging information. |
| "fileName": "A String", # The uploaded file's name. This field is present whether a video file or |
| # another type of file was uploaded. |
| "videoStreams": [ # A list of video streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about a video stream. |
| { # Information about a video stream. |
| "bitrateBps": "A String", # The video stream's bitrate, in bits per second. |
| "heightPixels": 42, # The encoded video content's height in pixels. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value is |
| # a four-letter vendor code. |
| "rotation": "A String", # The amount that YouTube needs to rotate the original source content |
| # to properly display the video. |
| "codec": "A String", # The video codec that the stream uses. |
| "frameRateFps": 3.14, # The video stream's frame rate, in frames per second. |
| "aspectRatio": 3.14, # The video content's display aspect ratio, which specifies the aspect |
| # ratio in which the video should be displayed. |
| "widthPixels": 42, # The encoded video content's width in pixels. You can calculate the |
| # video's encoding aspect ratio as |
| # <code>width_pixels</code>&nbsp;/&nbsp;<code>height_pixels</code>. |
| }, |
| ], |
| "audioStreams": [ # A list of audio streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about an audio stream. |
| { # Information about an audio stream. |
| "codec": "A String", # The audio codec that the stream uses. |
| "channelCount": 42, # The number of audio channels that the stream contains. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value |
| # is a four-letter vendor code. |
| "bitrateBps": "A String", # The audio stream's bitrate, in bits per second. |
| }, |
| ], |
| "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits |
| # per second. |
| "durationMs": "A String", # The length of the uploaded video in milliseconds. |
| "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing |
| # engine. Currently, YouTube only processes video files, but this field |
| # is present whether a video file or another type of file was uploaded. |
| "fileSize": "A String", # The uploaded file's size in bytes. This field is present whether |
| # a video file or another type of file was uploaded. |
| "container": "A String", # The uploaded video file's container format. |
| "creationTime": "A String", # The date and time when the uploaded video file was created. The value is |
| # specified in <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. Currently, the following ISO 8601 formats are supported: |
| # <ul> |
| # <li>Date only: <code>YYYY-MM-DD</code></li> |
| # <li>Naive time: <code>YYYY-MM-DDTHH:MM:SS</code></li> |
| # <li>Time with timezone: <code>YYYY-MM-DDTHH:MM:SS+HH:MM</code></li> |
| # </ul> |
| }, |
| "ageGating": { # Age restriction details related to a video. This data can only be retrieved |
| # by the video owner. |
| "videoGameRating": "A String", # Video game rating, if any. |
| "alcoholContent": True or False, # Indicates whether or not the video has alcoholic beverage content. Only |
| # users of legal purchasing age in a particular country, as identified by |
| # ICAP, can view the content. |
| "restricted": True or False, # Age-restricted trailers. For redband trailers and adult-rated video-games. |
| # Only users aged 18+ can view the content. The the field is |
| # <code>true</code> the content is restricted to viewers aged 18+. Otherwise |
| # The field won't be present. |
| }, |
| "kind": "youtube#video", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#video"</code>. |
| "suggestions": { # Specifies suggestions on how to improve video content, # The <code>suggestions</code> object encapsulates suggestions that identify |
| # opportunities to improve the video quality or the metadata for the uploaded |
| # video. This data can only be retrieved by the video owner. |
| # including encoding hints, tag suggestions, and editor suggestions. |
| "processingHints": [ # A list of suggestions that may improve YouTube's ability to process the |
| # video. |
| "A String", |
| ], |
| "tagSuggestions": [ # A list of keyword tags that could be added to the video's metadata to |
| # increase the likelihood that users will locate your video when searching |
| # or browsing on YouTube. |
| { # A single tag suggestion with it's relevance information. |
| "tag": "A String", # The keyword tag suggested for the video. |
| "categoryRestricts": [ # A set of video categories for which the tag is relevant. You can use this |
| # information to display appropriate tag suggestions based on the video |
| # category that the video uploader associates with the video. By default, |
| # tag suggestions are relevant for all categories if there are no restricts |
| # defined for the keyword. |
| "A String", |
| ], |
| }, |
| ], |
| "processingErrors": [ # A list of errors that will prevent YouTube from successfully processing |
| # the uploaded video video. These errors indicate that, regardless of the |
| # video's current <a href="#processingProgress.processingStatus">processing |
| # status</a>, eventually, that status will almost certainly be |
| # <code>failed</code>. |
| "A String", |
| ], |
| "editorSuggestions": [ # A list of video editing operations that might improve the video quality |
| # or playback experience of the uploaded video. |
| "A String", |
| ], |
| "processingWarnings": [ # A list of reasons why YouTube may have difficulty transcoding the |
| # uploaded video or that might result in an erroneous transcoding. |
| # These warnings are generated before YouTube actually processes the |
| # uploaded video file. In addition, they identify issues that are unlikely |
| # to cause the video processing to fail but that might cause problems |
| # such as sync issues, video artifacts, or a missing audio track. |
| "A String", |
| ], |
| }, |
| }, |
| ], |
| "pageInfo": { # Paging details for lists of resources, including total number of items # General pagination information. |
| # available and number of resources returned in a single page. |
| "resultsPerPage": 42, # The number of results included in the API response. |
| "totalResults": 42, # The total number of results in the result set. |
| }, |
| "prevPageToken": "A String", # The token that can be used as the value of the <code>pageToken</code> |
| # parameter to retrieve the previous page in the result set. |
| "visitorId": "A String", # The <code>visitorId</code> identifies the visitor. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| <pre>Retrieves the next page of results. |
| |
| Args: |
| previous_request: The request for the previous page. (required) |
| previous_response: The response from the request for the previous page. (required) |
| |
| Returns: |
| A request object that you can call 'execute()' on to request the next |
| page. Returns None if there are no more items in the collection. |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="rate">rate(id, rating, x__xgafv=None)</code> |
| <pre>Adds a like or dislike rating to a video or removes a rating from a video. |
| |
| Args: |
| id: string, A parameter (required) |
| rating: string, A parameter (required) |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="reportAbuse">reportAbuse(body=None, onBehalfOfContentOwner=None, x__xgafv=None)</code> |
| <pre>Report abuse for a video. |
| |
| Args: |
| body: object, The request body. |
| The object takes the form of: |
| |
| { |
| "secondaryReasonId": "A String", # The specific, or secondary, reason that this content is abusive (if |
| # available). The value is an abuse report reason ID that is a valid |
| # secondary reason for the primary reason. |
| "language": "A String", # The language that the content was viewed in. |
| "videoId": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "reasonId": "A String", # The high-level, or primary, reason that the content is abusive. The value |
| # is an abuse report reason ID. |
| "comments": "A String", # Additional comments regarding the abuse report. |
| } |
| |
| onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwner</strong></code> 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. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="update">update(part, body=None, onBehalfOfContentOwner=None, x__xgafv=None)</code> |
| <pre>Updates an existing resource. |
| |
| Args: |
| part: string, The <code><strong>part</strong></code> parameter serves two purposes in |
| this operation. It identifies the properties that the write operation will |
| set as well as the properties that the API response will |
| include.<br/><br/>Note that this method will override the existing values |
| for all of the mutable properties that are contained in any parts that the |
| parameter value specifies. For example, a |
| video's privacy setting is contained in the <code>status</code> part. As |
| such, if your request is updating a private video, and the request's |
| <code>part</code> parameter value includes the <code>status</code> part, |
| the |
| video's privacy setting will be updated to whatever value the request body |
| specifies. If the request body does not specify a value, the existing |
| privacy setting will be removed and the video will revert to the default |
| privacy setting.<br/><br/>In addition, not all parts contain properties |
| that can be set when inserting or updating a video. For example, the |
| <code>statistics</code> object encapsulates statistics that YouTube |
| calculates for a video and does not contain values that you can set or |
| modify. If the parameter value specifies a <code>part</code> that does not |
| contain mutable values, that <code>part</code> will still be included in |
| the API response. (required) (repeated) |
| body: object, The request body. |
| The object takes the form of: |
| |
| { # A <code><strong>video</strong></code> resource represents a YouTube video. |
| "recordingDetails": { # Recording information associated with the video. # The <code>recordingDetails</code> object encapsulates information about the |
| # location, date and address where the video was recorded. |
| "locationDescription": "A String", # The text description of the location where the video was recorded. |
| "recordingDate": "A String", # The date and time when the video was recorded. The value is specified in <a |
| # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # (<code>YYYY-MM-DDThh:mm:ss.sssZ</code>) format. |
| "location": { # Geographical coordinates of a point, in WGS84. # The geolocation information associated with the video. |
| "latitude": 3.14, # Latitude in degrees. |
| "longitude": 3.14, # Longitude in degrees. |
| "altitude": 3.14, # Altitude above the reference ellipsoid, in meters. |
| }, |
| }, |
| "contentDetails": { # Details about the content of a YouTube Video. # The <code>contentDetails</code> object contains information about the video |
| # content, including the length of the video and its aspect ratio. |
| "dimension": "A String", # The value of <code>dimension</code> indicates whether the video is |
| # available in 3D or in 2D. |
| "caption": "A String", # The value of <code>captions</code> indicates whether the video |
| # has captions or not. |
| "duration": "A String", # The length of the video. The tag value is an <a |
| # href="//en.wikipedia.org/wiki/ISO_8601#Durations">ISO 8601</a> duration in |
| # the format <code>PT#M#S</code>, in which the letters <code>PT</code> |
| # indicate that the value specifies a period of time, and the letters |
| # <code>M</code> and <code>S</code> refer to length in minutes and seconds, |
| # respectively. The <code>#</code> characters preceding the <code>M</code> |
| # and <code>S</code> letters are both integers that specify the number of |
| # minutes (or seconds) of the video. For example, a value of |
| # <code>PT15M51S</code> indicates that the video is 15 minutes and 51 seconds |
| # long. |
| "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom |
| # thumbnail image for the video. |
| # This property is only visible to the video uploader. |
| "regionRestriction": { # DEPRECATED Region restriction of the video. # The <code>regionRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. The object will contain |
| # either the <code>contentDetails.regionRestriction.allowed</code> property |
| # or the <code>contentDetails.regionRestriction.blocked</code> property. |
| "allowed": [ # A list of region codes that identify countries where the video is |
| # viewable. If this property is present and a country is not listed |
| # in its value, then the video is blocked from appearing in that |
| # country. If this property is present and contains an empty list, |
| # the video is blocked in all countries. |
| "A String", |
| ], |
| "blocked": [ # A list of region codes that identify countries where the video is |
| # blocked. If this property is present and a country is not listed in |
| # its value, then the video is viewable in that country. If this |
| # property is present and contains an empty list, the video is |
| # viewable in all countries. |
| "A String", |
| ], |
| }, |
| "licensedContent": True or False, # The value of <code>is_license_content</code> indicates whether the video is |
| # licensed content. |
| "countryRestriction": { # Rights management policy for YouTube resources. # The <code>countryRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| "definition": "A String", # The value of <code>definition</code> indicates whether the video is |
| # available in high definition or only in standard definition. |
| "contentRating": { # Ratings schemes. The country-specific ratings are mostly for # Specifies the ratings that the video received under various rating schemes. |
| # movies and shows. |
| # LINT.IfChange |
| "cscfRating": "A String", # The video's rating from Luxembourg's Commission de surveillance |
| # de la classification des films (CSCF). |
| "icaaRating": "A String", # The video's Instituto de la Cinematograf&iacute;a y de las Artes |
| # Audiovisuales (ICAA - Spain) rating. |
| "mpaaRating": "A String", # The video's Motion Picture Association of America (MPAA) rating. |
| "nbcRating": "A String", # The video's rating from the Maldives National Bureau of Classification. |
| "oflcRating": "A String", # The video's Office of Film and Literature Classification |
| # (OFLC - New Zealand) rating. |
| "fcbmRating": "A String", # The video's rating from Malaysia's Film Censorship Board. |
| "fpbRating": "A String", # The video's rating from South Africa's Film and Publication Board. |
| "djctqRating": "A String", # The video's Departamento de Justi&ccedil;a, Classifica&ccedil;&atilde;o, |
| # Qualifica&ccedil;&atilde;o e T&iacute;tulos (DJCQT - Brazil) rating. |
| "mpaatRating": "A String", # The rating system for trailer, DVD, and Ad in the US. See |
| # http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html. |
| "chfilmRating": "A String", # The video's rating in Switzerland. |
| "nmcRating": "A String", # The National Media Council ratings system for United Arab Emirates. |
| "acbRating": "A String", # The video's Australian Classification Board (ACB) or Australian |
| # Communications and Media Authority (ACMA) rating. ACMA ratings are used |
| # to classify children's television programming. |
| "mccaaRating": "A String", # The video's rating from Malta's Film Age-Classification Board. |
| "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attivit&agrave; |
| # Culturali e del Turismo (Italy). |
| "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian French-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/frenchsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "moctwRating": "A String", # The video's rating from Taiwan's Ministry of Culture |
| # (&#25991;&#21270;&#37096;). |
| "nkclvRating": "A String", # The video's rating from the Nacion&atilde;lais Kino centrs (National Film |
| # Centre of Latvia). |
| "csaRating": "A String", # The video's rating from France's Conseil sup&eacute;rieur de |
| # l’audiovisuel, which rates broadcast content. |
| "rteRating": "A String", # The video's rating from Ireland's Raidi&oacute; Teilif&iacute;s |
| # &Eacute;ireann. |
| "ifcoRating": "A String", # The video's Irish Film Classification Office (IFCO - Ireland) rating. |
| # See the <a |
| # href="http://www.ifco.ie/website/ifco/ifcoweb.nsf/web/classcatintro">IFCO</a> |
| # website for more information. |
| "cceRating": "A String", # The video's rating from Portugal's Comiss&atilde;o de |
| # Classifica&ccedil;&atilde;o de Espect&acute;culos. |
| "ecbmctRating": "A String", # Rating system in Turkey - Evaluation and Classification Board of the |
| # Ministry of Culture and Tourism |
| "egfilmRating": "A String", # The video's rating in Egypt. |
| "eirinRating": "A String", # The video's Eirin (&#26144;&#20523;) rating. |
| # Eirin is the Japanese rating system. |
| "ilfilmRating": "A String", # The video's rating in Israel. |
| "bmukkRating": "A String", # The video's rating from the Austrian Board of Media Classification |
| # (Bundesministerium f&uuml;r Unterricht, Kunst und Kultur). |
| "fpbRatingReasons": [ # Reasons that explain why the video received its FPB (South Africa) rating. |
| "A String", |
| ], |
| "tvpgRating": "A String", # The video's TV Parental Guidelines (TVPG) rating. |
| "smaisRating": "A String", # The video's rating in Iceland. |
| "mekuRating": "A String", # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti |
| # (National Audiovisual Institute). |
| "smsaRating": "A String", # The video's rating from Statens medier&aring;d (Sweden's National Media |
| # Council). |
| "lsfRating": "A String", # The video's rating from Indonesia's Lembaga Sensor Film. |
| "nbcplRating": "A String", # The video's rating in Poland. |
| "ytRating": "A String", # A rating that YouTube uses to identify age-restricted content. |
| "czfilmRating": "A String", # The video's rating in the Czech Republic. |
| "kijkwijzerRating": "A String", # The video's NICAM/Kijkwijzer rating from the Nederlands Instituut |
| # voor de Classificatie van Audiovisuele Media (Netherlands). |
| "rcnofRating": "A String", # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating |
| # Committee of the National Office of Film. |
| "cncRating": "A String", # Rating system in France - Commission de classification cinematographique |
| "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating. |
| "cicfRating": "A String", # The video's rating from the Commission de Contr&ocirc;le des Films |
| # (Belgium). |
| "fcoRating": "A String", # The video's rating from Hong Kong's Office for Film, Newspaper |
| # and Article Administration. |
| "catvRating": "A String", # Rating system for Canadian TV - Canadian TV Classification System |
| # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian English-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/englishsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "resorteviolenciaRating": "A String", # The video's rating in Venezuela. |
| "russiaRating": "A String", # The video's National Film Registry of the Russian Federation |
| # (MKRF - Russia) rating. |
| "kfcbRating": "A String", # The video's rating from the Kenya Film Classification Board. |
| "bfvcRating": "A String", # The video's rating from Thailand's Board of Film and Video Censors. |
| "medietilsynetRating": "A String", # The video's rating from Medietilsynet, the Norwegian Media Authority. |
| "djctqRatingReasons": [ # Reasons that explain why the video received its DJCQT (Brazil) rating. |
| "A String", |
| ], |
| "agcomRating": "A String", # The video's rating from Italy's Autorit&agrave; per le Garanzie nelle |
| # Comunicazioni (AGCOM). |
| "pefilmRating": "A String", # The video's rating in Peru. |
| "mcstRating": "A String", # The video's rating system for Vietnam - MCST |
| "mccypRating": "A String", # The video's rating from the Danish Film Institute's (Det Danske |
| # Filminstitut) Media Council for Children and Young People. |
| "grfilmRating": "A String", # The video's rating in Greece. |
| "bbfcRating": "A String", # The video's British Board of Film Classification (BBFC) rating. |
| "menaMpaaRating": "A String", # The rating system for MENA countries, a clone of MPAA. It is needed to |
| # prevent titles go live w/o additional QC check, since some of them can be |
| # inappropriate for the countries at all. See b/33408548 for more details. |
| "chvrsRating": "A String", # The video's Canadian Home Video Rating System (CHVRS) rating. |
| "mdaRating": "A String", # The video's rating from Singapore's Media Development Authority (MDA) and, |
| # specifically, it's Board of Film Censors (BFC). |
| "kmrbRating": "A String", # The video's Korea Media Rating Board |
| # (&#50689;&#49345;&#47932;&#46321;&#44553;&#50948;&#50896;&#54924;) rating. |
| # The KMRB rates videos in South Korea. |
| "nfrcRating": "A String", # The video's rating from the <a href="http://www.nfc.bg/">Bulgarian |
| # National Film Center</a>. |
| "fmocRating": "A String", # <span class="deprecated">This property has been deprecated. Use the |
| # <code><a |
| # href="#contentDetails.contentRating.cncRating">contentDetails.contentRating.cncRating</a></code> |
| # instead.</span> |
| "eefilmRating": "A String", # The video's rating in Estonia. |
| "cnaRating": "A String", # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI |
| # (CNA). |
| "fskRating": "A String", # The video's Freiwillige Selbstkontrolle der Filmwirtschaft |
| # (FSK - Germany) rating. |
| "skfilmRating": "A String", # The video's rating in Slovakia. |
| "incaaRating": "A String", # The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales - |
| # Argentina) rating. |
| "mocRating": "A String", # The video's Ministerio de Cultura (Colombia) rating. |
| "rtcRating": "A String", # The video's General Directorate of Radio, Television and Cinematography |
| # (Mexico) rating. |
| "anatelRating": "A String", # The video's Anatel (Asociaci&oacute;n Nacional de Televisi&oacute;n) |
| # rating for Chilean television. |
| "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and |
| # Classification Board (Philippines). |
| "cccRating": "A String", # The video's Consejo de Calificaci&oacute;n Cinematogr&aacute;fica (Chile) |
| # rating. |
| "nfvcbRating": "A String", # The video's rating from Nigeria's National Film and Video Censors Board. |
| }, |
| "projection": "A String", # Specifies the projection format of the video. |
| }, |
| "projectDetails": { # Project specific details about the content of a YouTube Video. # The <code>projectDetails</code> object contains information about the |
| # project specific video metadata. |
| "tags": [ # A list of project tags associated with the video during the upload. |
| "A String", |
| ], |
| }, |
| "id": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "localizations": { # The <code>localizations</code> object contains localized versions of the |
| # basic details about the video, such as its title and description. |
| "a_key": { # Localized versions of certain video properties (e.g. title). |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| }, |
| "monetizationDetails": { # Details about monetization of a YouTube Video. # The <code>monetizationDetails</code> object encapsulates information |
| # about the monetization status of the video. |
| "access": { # Rights management policy for YouTube resources. # The value of <code>access</code> indicates whether the video can be |
| # monetized or not. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| }, |
| "status": { # Basic details about a video category, such as its localized title. # The <code>status</code> object contains information about the video's |
| # uploading, processing, and privacy statuses. |
| # Next Id: 17 |
| "failureReason": "A String", # This value explains why a video failed to upload. This property is |
| # only present if the <code>uploadStatus</code> property indicates that |
| # the upload failed. |
| "privacyStatus": "A String", # The video's privacy status. |
| "selfDeclaredMadeForKids": True or False, |
| "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This |
| # property is only present if the <code>uploadStatus</code> property |
| # indicates that the upload was rejected. |
| "embeddable": True or False, # This value indicates if the video can be embedded on another website. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set |
| # only if the privacy status of the video is private. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| "madeForKids": True or False, |
| "license": "A String", # The video's license. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page |
| # can be viewed by everyone. Note that the view count, likes, etc will still |
| # be visible if this is disabled. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "uploadStatus": "A String", # The status of the uploaded video. |
| }, |
| "statistics": { # Statistics about the video, such as the number of times the video was viewed # The <code>statistics</code> object contains statistics about the video. |
| # or liked. |
| "likeCount": "A String", # The number of users who have indicated that they liked the video by |
| # giving it a positive rating. |
| "dislikeCount": "A String", # The number of users who have indicated that they disliked the video by |
| # giving it a negative rating. |
| "favoriteCount": "A String", # The number of users who currently have the video marked as a favorite |
| # video. |
| "commentCount": "A String", # The number of comments for the video. |
| "viewCount": "A String", # The number of times the video has been viewed. |
| }, |
| "snippet": { # Basic details about a video, including title, description, uploader, # The <code>snippet</code> object contains basic details about the video, |
| # such as its title, description, and category. |
| # thumbnails and category. |
| "localized": { # Localized versions of certain video properties (e.g. title). # Localized snippet selected with the hl parameter. If no such localization |
| # exists, this field is populated with the default snippet. (Read-only) |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| "tags": [ # A list of keyword tags associated with the video. Tags may contain spaces. |
| "A String", |
| ], |
| "defaultLanguage": "A String", # The language of the videos's default snippet. |
| "title": "A String", # The video's title. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "liveBroadcastContent": "A String", # Indicates if the video is an upcoming/active live broadcast. |
| # Or it's "none" if the video is not an upcoming/active live broadcast. |
| "description": "A String", # The video's description. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "channelTitle": "A String", # Channel title for the channel that the video belongs to. |
| "defaultAudioLanguage": "A String", # The <code>default_audio_language</code> property specifies the language |
| # spoken in the video's default audio track. |
| "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel that the |
| # video was uploaded to. |
| "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the video. For each object in the |
| # map, the key is the name of the thumbnail image, and the value is an object |
| # that contains other information about the thumbnail. |
| "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| }, |
| "categoryId": "A String", # The YouTube <a href="/youtube/v3/docs/videoCategories/list">video |
| # category</a> associated with the video. |
| "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "processingDetails": { # Describes processing status and progress and availability of some other Video # The <code>processingDetails</code> object encapsulates information about |
| # YouTube's progress in processing the uploaded video file. The properties |
| # in the object identify the current processing status and an estimate of |
| # the time remaining until YouTube finishes processing the video. This part |
| # also indicates whether different types of data or content, such as file |
| # details or thumbnail images, are available for the video.<br><br> |
| # The <code>processingProgress</code> object is designed to be polled so |
| # that the video uploaded can track the progress that YouTube has made in |
| # processing the uploaded video file. This data can only be retrieved by |
| # the video owner. |
| # resource parts. |
| "fileDetailsAvailability": "A String", # This value indicates whether file details are available for the uploaded |
| # video. You can retrieve a video's file details by requesting the |
| # <code>fileDetails</code> part in your <code>videos.list()</code> request. |
| "processingFailureReason": "A String", # The reason that YouTube failed to process the video. This property will |
| # only have a value if the <code>processingStatus</code> |
| # property's value is <code>failed</code>. |
| "editorSuggestionsAvailability": "A String", # This value indicates whether video editing suggestions, which might |
| # improve video quality or the playback experience, are available for |
| # the video. You can retrieve these suggestions by requesting the |
| # <code>suggestions</code> part in your <code>videos.list()</code> request. |
| "tagSuggestionsAvailability": "A String", # This value indicates whether keyword (tag) suggestions are available for |
| # the video. Tags can be added to a video's metadata to make it easier for |
| # other users to find the video. You can retrieve these suggestions by |
| # requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingProgress": { # Video processing progress and completion time estimate. # The <code>processingProgress</code> object contains information about the |
| # progress YouTube has made in processing the video. The values are really |
| # only relevant if the video's processing status is <code>processing</code>. |
| "timeLeftMs": "A String", # An estimate of the amount of time, in millseconds, that YouTube needs |
| # to finish processing the video. |
| "partsProcessed": "A String", # The number of parts of the video that YouTube has already processed. |
| # You can estimate the percentage of the video that YouTube has already |
| # processed by calculating:<br> |
| # <code>100 * parts_processed / parts_total</code><br><br> |
| # Note that since the estimated number of parts could increase without |
| # a corresponding increase in the number of parts that have already been |
| # processed, it is possible that the calculated progress could |
| # periodically decrease while YouTube processes a video. |
| "partsTotal": "A String", # An estimate of the total number of parts that need to be processed |
| # for the video. The number may be updated with more precise estimates |
| # while YouTube processes the video. |
| }, |
| "thumbnailsAvailability": "A String", # This value indicates whether thumbnail images have been generated for |
| # the video. |
| "processingIssuesAvailability": "A String", # This value indicates whether the video processing engine has generated |
| # suggestions that might improve YouTube's ability to process the |
| # the video, warnings that explain video processing problems, or |
| # errors that cause video processing problems. You can retrieve these |
| # suggestions by requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingStatus": "A String", # The video's processing status. This value indicates whether YouTube was |
| # able to process the video or if the video is still being processed. |
| }, |
| "etag": "A String", # Etag of this resource. |
| "player": { # Player to be used for a video playback. # The <code>player</code> object contains information that you would use to |
| # play the video in an embedded player. |
| "embedWidth": "A String", # The embed width |
| "embedHeight": "A String", |
| "embedHtml": "A String", # An <code>&lt;iframe&gt;</code> tag that embeds a player that will |
| # play the video. |
| }, |
| "liveStreamingDetails": { # Details about the live streaming metadata. # The <code>liveStreamingDetails</code> object contains metadata about a live |
| # video broadcast. The object will only be present in a <code>video</code> |
| # resource if the video is an upcoming, live, or completed live broadcast. |
| "activeLiveChatId": "A String", # The ID of the currently active live chat attached to this video. This |
| # field is filled only if the video is a currently live broadcast that has |
| # live chat. Once the broadcast transitions to complete this field will be |
| # removed and the live chat closed down. For persistent broadcasts that live |
| # chat id will no longer be tied to this video but rather to the new video |
| # being displayed at the persistent page. |
| "concurrentViewers": "A String", # The number of viewers currently watching the broadcast. The property and |
| # its value will be present if the broadcast has current viewers and the |
| # broadcast owner has not hidden the viewcount for the video. Note that |
| # YouTube stops tracking the number of concurrent viewers for a broadcast |
| # when the broadcast ends. So, this property would not identify the number |
| # of viewers watching an archived video of a live broadcast that already |
| # ended. |
| "scheduledEndTime": "A String", # The time that the broadcast is scheduled to end. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. If the value is empty or |
| # the property is not present, then the broadcast is scheduled to continue |
| # indefinitely. |
| "actualStartTime": "A String", # The time that the broadcast actually started. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast begins. |
| "actualEndTime": "A String", # The time that the broadcast actually ended. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast is over. |
| "scheduledStartTime": "A String", # The time that the broadcast is scheduled to begin. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "topicDetails": { # Freebase topic information related to the video. # The <code>topicDetails</code> object encapsulates information about <a |
| # href="http://www.freebase.com">Freebase</a> topics associated with the |
| # video. |
| "topicCategories": [ # A list of Wikipedia URLs that provide a high-level description of the |
| # video's content. |
| "A String", |
| ], |
| "relevantTopicIds": [ # Similar to topic_id, except that these topics are merely relevant to the |
| # video. These are topics that may be mentioned in, or appear in the video. |
| # You can retrieve information about each topic using <a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| "topicIds": [ # A list of Freebase topic IDs that are centrally associated with the video. |
| # These are topics that are centrally featured in the video, and it can be |
| # said that the video is mainly about each of these. You can retrieve |
| # information about each topic using the < a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| }, |
| "fileDetails": { # Describes original video file properties, including technical details about # The <code>fileDetails</code> object encapsulates information about the |
| # video file that was uploaded to YouTube, including the file's resolution, |
| # duration, audio and video codecs, stream bitrates, and more. This data can |
| # only be retrieved by the video owner. |
| # audio and video streams, but also metadata information like content length, |
| # digitization time, or geotagging information. |
| "fileName": "A String", # The uploaded file's name. This field is present whether a video file or |
| # another type of file was uploaded. |
| "videoStreams": [ # A list of video streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about a video stream. |
| { # Information about a video stream. |
| "bitrateBps": "A String", # The video stream's bitrate, in bits per second. |
| "heightPixels": 42, # The encoded video content's height in pixels. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value is |
| # a four-letter vendor code. |
| "rotation": "A String", # The amount that YouTube needs to rotate the original source content |
| # to properly display the video. |
| "codec": "A String", # The video codec that the stream uses. |
| "frameRateFps": 3.14, # The video stream's frame rate, in frames per second. |
| "aspectRatio": 3.14, # The video content's display aspect ratio, which specifies the aspect |
| # ratio in which the video should be displayed. |
| "widthPixels": 42, # The encoded video content's width in pixels. You can calculate the |
| # video's encoding aspect ratio as |
| # <code>width_pixels</code>&nbsp;/&nbsp;<code>height_pixels</code>. |
| }, |
| ], |
| "audioStreams": [ # A list of audio streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about an audio stream. |
| { # Information about an audio stream. |
| "codec": "A String", # The audio codec that the stream uses. |
| "channelCount": 42, # The number of audio channels that the stream contains. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value |
| # is a four-letter vendor code. |
| "bitrateBps": "A String", # The audio stream's bitrate, in bits per second. |
| }, |
| ], |
| "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits |
| # per second. |
| "durationMs": "A String", # The length of the uploaded video in milliseconds. |
| "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing |
| # engine. Currently, YouTube only processes video files, but this field |
| # is present whether a video file or another type of file was uploaded. |
| "fileSize": "A String", # The uploaded file's size in bytes. This field is present whether |
| # a video file or another type of file was uploaded. |
| "container": "A String", # The uploaded video file's container format. |
| "creationTime": "A String", # The date and time when the uploaded video file was created. The value is |
| # specified in <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. Currently, the following ISO 8601 formats are supported: |
| # <ul> |
| # <li>Date only: <code>YYYY-MM-DD</code></li> |
| # <li>Naive time: <code>YYYY-MM-DDTHH:MM:SS</code></li> |
| # <li>Time with timezone: <code>YYYY-MM-DDTHH:MM:SS+HH:MM</code></li> |
| # </ul> |
| }, |
| "ageGating": { # Age restriction details related to a video. This data can only be retrieved |
| # by the video owner. |
| "videoGameRating": "A String", # Video game rating, if any. |
| "alcoholContent": True or False, # Indicates whether or not the video has alcoholic beverage content. Only |
| # users of legal purchasing age in a particular country, as identified by |
| # ICAP, can view the content. |
| "restricted": True or False, # Age-restricted trailers. For redband trailers and adult-rated video-games. |
| # Only users aged 18+ can view the content. The the field is |
| # <code>true</code> the content is restricted to viewers aged 18+. Otherwise |
| # The field won't be present. |
| }, |
| "kind": "youtube#video", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#video"</code>. |
| "suggestions": { # Specifies suggestions on how to improve video content, # The <code>suggestions</code> object encapsulates suggestions that identify |
| # opportunities to improve the video quality or the metadata for the uploaded |
| # video. This data can only be retrieved by the video owner. |
| # including encoding hints, tag suggestions, and editor suggestions. |
| "processingHints": [ # A list of suggestions that may improve YouTube's ability to process the |
| # video. |
| "A String", |
| ], |
| "tagSuggestions": [ # A list of keyword tags that could be added to the video's metadata to |
| # increase the likelihood that users will locate your video when searching |
| # or browsing on YouTube. |
| { # A single tag suggestion with it's relevance information. |
| "tag": "A String", # The keyword tag suggested for the video. |
| "categoryRestricts": [ # A set of video categories for which the tag is relevant. You can use this |
| # information to display appropriate tag suggestions based on the video |
| # category that the video uploader associates with the video. By default, |
| # tag suggestions are relevant for all categories if there are no restricts |
| # defined for the keyword. |
| "A String", |
| ], |
| }, |
| ], |
| "processingErrors": [ # A list of errors that will prevent YouTube from successfully processing |
| # the uploaded video video. These errors indicate that, regardless of the |
| # video's current <a href="#processingProgress.processingStatus">processing |
| # status</a>, eventually, that status will almost certainly be |
| # <code>failed</code>. |
| "A String", |
| ], |
| "editorSuggestions": [ # A list of video editing operations that might improve the video quality |
| # or playback experience of the uploaded video. |
| "A String", |
| ], |
| "processingWarnings": [ # A list of reasons why YouTube may have difficulty transcoding the |
| # uploaded video or that might result in an erroneous transcoding. |
| # These warnings are generated before YouTube actually processes the |
| # uploaded video file. In addition, they identify issues that are unlikely |
| # to cause the video processing to fail but that might cause problems |
| # such as sync issues, video artifacts, or a missing audio track. |
| "A String", |
| ], |
| }, |
| } |
| |
| onBehalfOfContentOwner: string, <strong>Note:</strong> This parameter is intended exclusively for YouTube |
| content partners.<br><br>The |
| <code><strong>onBehalfOfContentOwner</strong></code> 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 actual |
| CMS account that the user authenticates with must be linked to the |
| specified YouTube content owner. |
| x__xgafv: string, V1 error format. |
| Allowed values |
| 1 - v1 error format |
| 2 - v2 error format |
| |
| Returns: |
| An object of the form: |
| |
| { # A <code><strong>video</strong></code> resource represents a YouTube video. |
| "recordingDetails": { # Recording information associated with the video. # The <code>recordingDetails</code> object encapsulates information about the |
| # location, date and address where the video was recorded. |
| "locationDescription": "A String", # The text description of the location where the video was recorded. |
| "recordingDate": "A String", # The date and time when the video was recorded. The value is specified in <a |
| # href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # (<code>YYYY-MM-DDThh:mm:ss.sssZ</code>) format. |
| "location": { # Geographical coordinates of a point, in WGS84. # The geolocation information associated with the video. |
| "latitude": 3.14, # Latitude in degrees. |
| "longitude": 3.14, # Longitude in degrees. |
| "altitude": 3.14, # Altitude above the reference ellipsoid, in meters. |
| }, |
| }, |
| "contentDetails": { # Details about the content of a YouTube Video. # The <code>contentDetails</code> object contains information about the video |
| # content, including the length of the video and its aspect ratio. |
| "dimension": "A String", # The value of <code>dimension</code> indicates whether the video is |
| # available in 3D or in 2D. |
| "caption": "A String", # The value of <code>captions</code> indicates whether the video |
| # has captions or not. |
| "duration": "A String", # The length of the video. The tag value is an <a |
| # href="//en.wikipedia.org/wiki/ISO_8601#Durations">ISO 8601</a> duration in |
| # the format <code>PT#M#S</code>, in which the letters <code>PT</code> |
| # indicate that the value specifies a period of time, and the letters |
| # <code>M</code> and <code>S</code> refer to length in minutes and seconds, |
| # respectively. The <code>#</code> characters preceding the <code>M</code> |
| # and <code>S</code> letters are both integers that specify the number of |
| # minutes (or seconds) of the video. For example, a value of |
| # <code>PT15M51S</code> indicates that the video is 15 minutes and 51 seconds |
| # long. |
| "hasCustomThumbnail": True or False, # Indicates whether the video uploader has provided a custom |
| # thumbnail image for the video. |
| # This property is only visible to the video uploader. |
| "regionRestriction": { # DEPRECATED Region restriction of the video. # The <code>regionRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. The object will contain |
| # either the <code>contentDetails.regionRestriction.allowed</code> property |
| # or the <code>contentDetails.regionRestriction.blocked</code> property. |
| "allowed": [ # A list of region codes that identify countries where the video is |
| # viewable. If this property is present and a country is not listed |
| # in its value, then the video is blocked from appearing in that |
| # country. If this property is present and contains an empty list, |
| # the video is blocked in all countries. |
| "A String", |
| ], |
| "blocked": [ # A list of region codes that identify countries where the video is |
| # blocked. If this property is present and a country is not listed in |
| # its value, then the video is viewable in that country. If this |
| # property is present and contains an empty list, the video is |
| # viewable in all countries. |
| "A String", |
| ], |
| }, |
| "licensedContent": True or False, # The value of <code>is_license_content</code> indicates whether the video is |
| # licensed content. |
| "countryRestriction": { # Rights management policy for YouTube resources. # The <code>countryRestriction</code> object contains information about the |
| # countries where a video is (or is not) viewable. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| "definition": "A String", # The value of <code>definition</code> indicates whether the video is |
| # available in high definition or only in standard definition. |
| "contentRating": { # Ratings schemes. The country-specific ratings are mostly for # Specifies the ratings that the video received under various rating schemes. |
| # movies and shows. |
| # LINT.IfChange |
| "cscfRating": "A String", # The video's rating from Luxembourg's Commission de surveillance |
| # de la classification des films (CSCF). |
| "icaaRating": "A String", # The video's Instituto de la Cinematograf&iacute;a y de las Artes |
| # Audiovisuales (ICAA - Spain) rating. |
| "mpaaRating": "A String", # The video's Motion Picture Association of America (MPAA) rating. |
| "nbcRating": "A String", # The video's rating from the Maldives National Bureau of Classification. |
| "oflcRating": "A String", # The video's Office of Film and Literature Classification |
| # (OFLC - New Zealand) rating. |
| "fcbmRating": "A String", # The video's rating from Malaysia's Film Censorship Board. |
| "fpbRating": "A String", # The video's rating from South Africa's Film and Publication Board. |
| "djctqRating": "A String", # The video's Departamento de Justi&ccedil;a, Classifica&ccedil;&atilde;o, |
| # Qualifica&ccedil;&atilde;o e T&iacute;tulos (DJCQT - Brazil) rating. |
| "mpaatRating": "A String", # The rating system for trailer, DVD, and Ad in the US. See |
| # http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html. |
| "chfilmRating": "A String", # The video's rating in Switzerland. |
| "nmcRating": "A String", # The National Media Council ratings system for United Arab Emirates. |
| "acbRating": "A String", # The video's Australian Classification Board (ACB) or Australian |
| # Communications and Media Authority (ACMA) rating. ACMA ratings are used |
| # to classify children's television programming. |
| "mccaaRating": "A String", # The video's rating from Malta's Film Age-Classification Board. |
| "mibacRating": "A String", # The video's rating from the Ministero dei Beni e delle Attivit&agrave; |
| # Culturali e del Turismo (Italy). |
| "catvfrRating": "A String", # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian French-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/frenchsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "moctwRating": "A String", # The video's rating from Taiwan's Ministry of Culture |
| # (&#25991;&#21270;&#37096;). |
| "nkclvRating": "A String", # The video's rating from the Nacion&atilde;lais Kino centrs (National Film |
| # Centre of Latvia). |
| "csaRating": "A String", # The video's rating from France's Conseil sup&eacute;rieur de |
| # l’audiovisuel, which rates broadcast content. |
| "rteRating": "A String", # The video's rating from Ireland's Raidi&oacute; Teilif&iacute;s |
| # &Eacute;ireann. |
| "ifcoRating": "A String", # The video's Irish Film Classification Office (IFCO - Ireland) rating. |
| # See the <a |
| # href="http://www.ifco.ie/website/ifco/ifcoweb.nsf/web/classcatintro">IFCO</a> |
| # website for more information. |
| "cceRating": "A String", # The video's rating from Portugal's Comiss&atilde;o de |
| # Classifica&ccedil;&atilde;o de Espect&acute;culos. |
| "ecbmctRating": "A String", # Rating system in Turkey - Evaluation and Classification Board of the |
| # Ministry of Culture and Tourism |
| "egfilmRating": "A String", # The video's rating in Egypt. |
| "eirinRating": "A String", # The video's Eirin (&#26144;&#20523;) rating. |
| # Eirin is the Japanese rating system. |
| "ilfilmRating": "A String", # The video's rating in Israel. |
| "bmukkRating": "A String", # The video's rating from the Austrian Board of Media Classification |
| # (Bundesministerium f&uuml;r Unterricht, Kunst und Kultur). |
| "fpbRatingReasons": [ # Reasons that explain why the video received its FPB (South Africa) rating. |
| "A String", |
| ], |
| "tvpgRating": "A String", # The video's TV Parental Guidelines (TVPG) rating. |
| "smaisRating": "A String", # The video's rating in Iceland. |
| "mekuRating": "A String", # The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti |
| # (National Audiovisual Institute). |
| "smsaRating": "A String", # The video's rating from Statens medier&aring;d (Sweden's National Media |
| # Council). |
| "lsfRating": "A String", # The video's rating from Indonesia's Lembaga Sensor Film. |
| "nbcplRating": "A String", # The video's rating in Poland. |
| "ytRating": "A String", # A rating that YouTube uses to identify age-restricted content. |
| "czfilmRating": "A String", # The video's rating in the Czech Republic. |
| "kijkwijzerRating": "A String", # The video's NICAM/Kijkwijzer rating from the Nederlands Instituut |
| # voor de Classificatie van Audiovisuele Media (Netherlands). |
| "rcnofRating": "A String", # The video's rating from the Hungarian Nemzeti Filmiroda, the Rating |
| # Committee of the National Office of Film. |
| "cncRating": "A String", # Rating system in France - Commission de classification cinematographique |
| "cbfcRating": "A String", # The video's Central Board of Film Certification (CBFC - India) rating. |
| "cicfRating": "A String", # The video's rating from the Commission de Contr&ocirc;le des Films |
| # (Belgium). |
| "fcoRating": "A String", # The video's rating from Hong Kong's Office for Film, Newspaper |
| # and Article Administration. |
| "catvRating": "A String", # Rating system for Canadian TV - Canadian TV Classification System |
| # The video's rating from the Canadian Radio-Television and |
| # Telecommunications Commission (CRTC) for Canadian English-language |
| # broadcasts. For more information, see the |
| # <a href="http://www.cbsc.ca/english/agvot/englishsystem.php">Canadian |
| # Broadcast Standards Council</a> website. |
| "resorteviolenciaRating": "A String", # The video's rating in Venezuela. |
| "russiaRating": "A String", # The video's National Film Registry of the Russian Federation |
| # (MKRF - Russia) rating. |
| "kfcbRating": "A String", # The video's rating from the Kenya Film Classification Board. |
| "bfvcRating": "A String", # The video's rating from Thailand's Board of Film and Video Censors. |
| "medietilsynetRating": "A String", # The video's rating from Medietilsynet, the Norwegian Media Authority. |
| "djctqRatingReasons": [ # Reasons that explain why the video received its DJCQT (Brazil) rating. |
| "A String", |
| ], |
| "agcomRating": "A String", # The video's rating from Italy's Autorit&agrave; per le Garanzie nelle |
| # Comunicazioni (AGCOM). |
| "pefilmRating": "A String", # The video's rating in Peru. |
| "mcstRating": "A String", # The video's rating system for Vietnam - MCST |
| "mccypRating": "A String", # The video's rating from the Danish Film Institute's (Det Danske |
| # Filminstitut) Media Council for Children and Young People. |
| "grfilmRating": "A String", # The video's rating in Greece. |
| "bbfcRating": "A String", # The video's British Board of Film Classification (BBFC) rating. |
| "menaMpaaRating": "A String", # The rating system for MENA countries, a clone of MPAA. It is needed to |
| # prevent titles go live w/o additional QC check, since some of them can be |
| # inappropriate for the countries at all. See b/33408548 for more details. |
| "chvrsRating": "A String", # The video's Canadian Home Video Rating System (CHVRS) rating. |
| "mdaRating": "A String", # The video's rating from Singapore's Media Development Authority (MDA) and, |
| # specifically, it's Board of Film Censors (BFC). |
| "kmrbRating": "A String", # The video's Korea Media Rating Board |
| # (&#50689;&#49345;&#47932;&#46321;&#44553;&#50948;&#50896;&#54924;) rating. |
| # The KMRB rates videos in South Korea. |
| "nfrcRating": "A String", # The video's rating from the <a href="http://www.nfc.bg/">Bulgarian |
| # National Film Center</a>. |
| "fmocRating": "A String", # <span class="deprecated">This property has been deprecated. Use the |
| # <code><a |
| # href="#contentDetails.contentRating.cncRating">contentDetails.contentRating.cncRating</a></code> |
| # instead.</span> |
| "eefilmRating": "A String", # The video's rating in Estonia. |
| "cnaRating": "A String", # The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI |
| # (CNA). |
| "fskRating": "A String", # The video's Freiwillige Selbstkontrolle der Filmwirtschaft |
| # (FSK - Germany) rating. |
| "skfilmRating": "A String", # The video's rating in Slovakia. |
| "incaaRating": "A String", # The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales - |
| # Argentina) rating. |
| "mocRating": "A String", # The video's Ministerio de Cultura (Colombia) rating. |
| "rtcRating": "A String", # The video's General Directorate of Radio, Television and Cinematography |
| # (Mexico) rating. |
| "anatelRating": "A String", # The video's Anatel (Asociaci&oacute;n Nacional de Televisi&oacute;n) |
| # rating for Chilean television. |
| "mtrcbRating": "A String", # The video's rating from the Movie and Television Review and |
| # Classification Board (Philippines). |
| "cccRating": "A String", # The video's Consejo de Calificaci&oacute;n Cinematogr&aacute;fica (Chile) |
| # rating. |
| "nfvcbRating": "A String", # The video's rating from Nigeria's National Film and Video Censors Board. |
| }, |
| "projection": "A String", # Specifies the projection format of the video. |
| }, |
| "projectDetails": { # Project specific details about the content of a YouTube Video. # The <code>projectDetails</code> object contains information about the |
| # project specific video metadata. |
| "tags": [ # A list of project tags associated with the video during the upload. |
| "A String", |
| ], |
| }, |
| "id": "A String", # The ID that YouTube uses to uniquely identify the video. |
| "localizations": { # The <code>localizations</code> object contains localized versions of the |
| # basic details about the video, such as its title and description. |
| "a_key": { # Localized versions of certain video properties (e.g. title). |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| }, |
| "monetizationDetails": { # Details about monetization of a YouTube Video. # The <code>monetizationDetails</code> object encapsulates information |
| # about the monetization status of the video. |
| "access": { # Rights management policy for YouTube resources. # The value of <code>access</code> indicates whether the video can be |
| # monetized or not. |
| "exception": [ # A list of region codes that identify countries where the default policy do |
| # not apply. |
| "A String", |
| ], |
| "allowed": True or False, # The value of <code>allowed</code> indicates whether the access to the |
| # policy is allowed or denied by default. |
| }, |
| }, |
| "status": { # Basic details about a video category, such as its localized title. # The <code>status</code> object contains information about the video's |
| # uploading, processing, and privacy statuses. |
| # Next Id: 17 |
| "failureReason": "A String", # This value explains why a video failed to upload. This property is |
| # only present if the <code>uploadStatus</code> property indicates that |
| # the upload failed. |
| "privacyStatus": "A String", # The video's privacy status. |
| "selfDeclaredMadeForKids": True or False, |
| "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This |
| # property is only present if the <code>uploadStatus</code> property |
| # indicates that the upload was rejected. |
| "embeddable": True or False, # This value indicates if the video can be embedded on another website. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set |
| # only if the privacy status of the video is private. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| "madeForKids": True or False, |
| "license": "A String", # The video's license. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page |
| # can be viewed by everyone. Note that the view count, likes, etc will still |
| # be visible if this is disabled. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "uploadStatus": "A String", # The status of the uploaded video. |
| }, |
| "statistics": { # Statistics about the video, such as the number of times the video was viewed # The <code>statistics</code> object contains statistics about the video. |
| # or liked. |
| "likeCount": "A String", # The number of users who have indicated that they liked the video by |
| # giving it a positive rating. |
| "dislikeCount": "A String", # The number of users who have indicated that they disliked the video by |
| # giving it a negative rating. |
| "favoriteCount": "A String", # The number of users who currently have the video marked as a favorite |
| # video. |
| "commentCount": "A String", # The number of comments for the video. |
| "viewCount": "A String", # The number of times the video has been viewed. |
| }, |
| "snippet": { # Basic details about a video, including title, description, uploader, # The <code>snippet</code> object contains basic details about the video, |
| # such as its title, description, and category. |
| # thumbnails and category. |
| "localized": { # Localized versions of certain video properties (e.g. title). # Localized snippet selected with the hl parameter. If no such localization |
| # exists, this field is populated with the default snippet. (Read-only) |
| "title": "A String", # Localized version of the video's title. |
| "description": "A String", # Localized version of the video's description. |
| }, |
| "tags": [ # A list of keyword tags associated with the video. Tags may contain spaces. |
| "A String", |
| ], |
| "defaultLanguage": "A String", # The language of the videos's default snippet. |
| "title": "A String", # The video's title. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "liveBroadcastContent": "A String", # Indicates if the video is an upcoming/active live broadcast. |
| # Or it's "none" if the video is not an upcoming/active live broadcast. |
| "description": "A String", # The video's description. |
| # @mutable youtube.videos.insert youtube.videos.update |
| "channelTitle": "A String", # Channel title for the channel that the video belongs to. |
| "defaultAudioLanguage": "A String", # The <code>default_audio_language</code> property specifies the language |
| # spoken in the video's default audio track. |
| "channelId": "A String", # The ID that YouTube uses to uniquely identify the channel that the |
| # video was uploaded to. |
| "thumbnails": { # Internal representation of thumbnails for a YouTube resource. # A map of thumbnail images associated with the video. For each object in the |
| # map, the key is the name of the thumbnail image, and the value is an object |
| # that contains other information about the thumbnail. |
| "medium": { # A thumbnail is an image representing a YouTube resource. # The medium quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "standard": { # A thumbnail is an image representing a YouTube resource. # The standard quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "default": { # A thumbnail is an image representing a YouTube resource. # The default image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "maxres": { # A thumbnail is an image representing a YouTube resource. # The maximum resolution quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| "high": { # A thumbnail is an image representing a YouTube resource. # The high quality image for this resource. |
| "width": 42, # (Optional) Width of the thumbnail image. |
| "url": "A String", # The thumbnail image's URL. |
| "height": 42, # (Optional) Height of the thumbnail image. |
| }, |
| }, |
| "categoryId": "A String", # The YouTube <a href="/youtube/v3/docs/videoCategories/list">video |
| # category</a> associated with the video. |
| "publishedAt": "A String", # The date and time that the video was uploaded. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "processingDetails": { # Describes processing status and progress and availability of some other Video # The <code>processingDetails</code> object encapsulates information about |
| # YouTube's progress in processing the uploaded video file. The properties |
| # in the object identify the current processing status and an estimate of |
| # the time remaining until YouTube finishes processing the video. This part |
| # also indicates whether different types of data or content, such as file |
| # details or thumbnail images, are available for the video.<br><br> |
| # The <code>processingProgress</code> object is designed to be polled so |
| # that the video uploaded can track the progress that YouTube has made in |
| # processing the uploaded video file. This data can only be retrieved by |
| # the video owner. |
| # resource parts. |
| "fileDetailsAvailability": "A String", # This value indicates whether file details are available for the uploaded |
| # video. You can retrieve a video's file details by requesting the |
| # <code>fileDetails</code> part in your <code>videos.list()</code> request. |
| "processingFailureReason": "A String", # The reason that YouTube failed to process the video. This property will |
| # only have a value if the <code>processingStatus</code> |
| # property's value is <code>failed</code>. |
| "editorSuggestionsAvailability": "A String", # This value indicates whether video editing suggestions, which might |
| # improve video quality or the playback experience, are available for |
| # the video. You can retrieve these suggestions by requesting the |
| # <code>suggestions</code> part in your <code>videos.list()</code> request. |
| "tagSuggestionsAvailability": "A String", # This value indicates whether keyword (tag) suggestions are available for |
| # the video. Tags can be added to a video's metadata to make it easier for |
| # other users to find the video. You can retrieve these suggestions by |
| # requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingProgress": { # Video processing progress and completion time estimate. # The <code>processingProgress</code> object contains information about the |
| # progress YouTube has made in processing the video. The values are really |
| # only relevant if the video's processing status is <code>processing</code>. |
| "timeLeftMs": "A String", # An estimate of the amount of time, in millseconds, that YouTube needs |
| # to finish processing the video. |
| "partsProcessed": "A String", # The number of parts of the video that YouTube has already processed. |
| # You can estimate the percentage of the video that YouTube has already |
| # processed by calculating:<br> |
| # <code>100 * parts_processed / parts_total</code><br><br> |
| # Note that since the estimated number of parts could increase without |
| # a corresponding increase in the number of parts that have already been |
| # processed, it is possible that the calculated progress could |
| # periodically decrease while YouTube processes a video. |
| "partsTotal": "A String", # An estimate of the total number of parts that need to be processed |
| # for the video. The number may be updated with more precise estimates |
| # while YouTube processes the video. |
| }, |
| "thumbnailsAvailability": "A String", # This value indicates whether thumbnail images have been generated for |
| # the video. |
| "processingIssuesAvailability": "A String", # This value indicates whether the video processing engine has generated |
| # suggestions that might improve YouTube's ability to process the |
| # the video, warnings that explain video processing problems, or |
| # errors that cause video processing problems. You can retrieve these |
| # suggestions by requesting the <code>suggestions</code> part in your |
| # <code>videos.list()</code> request. |
| "processingStatus": "A String", # The video's processing status. This value indicates whether YouTube was |
| # able to process the video or if the video is still being processed. |
| }, |
| "etag": "A String", # Etag of this resource. |
| "player": { # Player to be used for a video playback. # The <code>player</code> object contains information that you would use to |
| # play the video in an embedded player. |
| "embedWidth": "A String", # The embed width |
| "embedHeight": "A String", |
| "embedHtml": "A String", # An <code>&lt;iframe&gt;</code> tag that embeds a player that will |
| # play the video. |
| }, |
| "liveStreamingDetails": { # Details about the live streaming metadata. # The <code>liveStreamingDetails</code> object contains metadata about a live |
| # video broadcast. The object will only be present in a <code>video</code> |
| # resource if the video is an upcoming, live, or completed live broadcast. |
| "activeLiveChatId": "A String", # The ID of the currently active live chat attached to this video. This |
| # field is filled only if the video is a currently live broadcast that has |
| # live chat. Once the broadcast transitions to complete this field will be |
| # removed and the live chat closed down. For persistent broadcasts that live |
| # chat id will no longer be tied to this video but rather to the new video |
| # being displayed at the persistent page. |
| "concurrentViewers": "A String", # The number of viewers currently watching the broadcast. The property and |
| # its value will be present if the broadcast has current viewers and the |
| # broadcast owner has not hidden the viewcount for the video. Note that |
| # YouTube stops tracking the number of concurrent viewers for a broadcast |
| # when the broadcast ends. So, this property would not identify the number |
| # of viewers watching an archived video of a live broadcast that already |
| # ended. |
| "scheduledEndTime": "A String", # The time that the broadcast is scheduled to end. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. If the value is empty or |
| # the property is not present, then the broadcast is scheduled to continue |
| # indefinitely. |
| "actualStartTime": "A String", # The time that the broadcast actually started. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast begins. |
| "actualEndTime": "A String", # The time that the broadcast actually ended. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. This value will not be |
| # available until the broadcast is over. |
| "scheduledStartTime": "A String", # The time that the broadcast is scheduled to begin. The value is specified |
| # in <a href="//www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. |
| }, |
| "topicDetails": { # Freebase topic information related to the video. # The <code>topicDetails</code> object encapsulates information about <a |
| # href="http://www.freebase.com">Freebase</a> topics associated with the |
| # video. |
| "topicCategories": [ # A list of Wikipedia URLs that provide a high-level description of the |
| # video's content. |
| "A String", |
| ], |
| "relevantTopicIds": [ # Similar to topic_id, except that these topics are merely relevant to the |
| # video. These are topics that may be mentioned in, or appear in the video. |
| # You can retrieve information about each topic using <a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| "topicIds": [ # A list of Freebase topic IDs that are centrally associated with the video. |
| # These are topics that are centrally featured in the video, and it can be |
| # said that the video is mainly about each of these. You can retrieve |
| # information about each topic using the < a |
| # href="http://wiki.freebase.com/wiki/Topic_API">Freebase Topic API</a>. |
| "A String", |
| ], |
| }, |
| "fileDetails": { # Describes original video file properties, including technical details about # The <code>fileDetails</code> object encapsulates information about the |
| # video file that was uploaded to YouTube, including the file's resolution, |
| # duration, audio and video codecs, stream bitrates, and more. This data can |
| # only be retrieved by the video owner. |
| # audio and video streams, but also metadata information like content length, |
| # digitization time, or geotagging information. |
| "fileName": "A String", # The uploaded file's name. This field is present whether a video file or |
| # another type of file was uploaded. |
| "videoStreams": [ # A list of video streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about a video stream. |
| { # Information about a video stream. |
| "bitrateBps": "A String", # The video stream's bitrate, in bits per second. |
| "heightPixels": 42, # The encoded video content's height in pixels. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value is |
| # a four-letter vendor code. |
| "rotation": "A String", # The amount that YouTube needs to rotate the original source content |
| # to properly display the video. |
| "codec": "A String", # The video codec that the stream uses. |
| "frameRateFps": 3.14, # The video stream's frame rate, in frames per second. |
| "aspectRatio": 3.14, # The video content's display aspect ratio, which specifies the aspect |
| # ratio in which the video should be displayed. |
| "widthPixels": 42, # The encoded video content's width in pixels. You can calculate the |
| # video's encoding aspect ratio as |
| # <code>width_pixels</code>&nbsp;/&nbsp;<code>height_pixels</code>. |
| }, |
| ], |
| "audioStreams": [ # A list of audio streams contained in the uploaded video file. Each item |
| # in the list contains detailed metadata about an audio stream. |
| { # Information about an audio stream. |
| "codec": "A String", # The audio codec that the stream uses. |
| "channelCount": 42, # The number of audio channels that the stream contains. |
| "vendor": "A String", # A value that uniquely identifies a video vendor. Typically, the value |
| # is a four-letter vendor code. |
| "bitrateBps": "A String", # The audio stream's bitrate, in bits per second. |
| }, |
| ], |
| "bitrateBps": "A String", # The uploaded video file's combined (video and audio) bitrate in bits |
| # per second. |
| "durationMs": "A String", # The length of the uploaded video in milliseconds. |
| "fileType": "A String", # The uploaded file's type as detected by YouTube's video processing |
| # engine. Currently, YouTube only processes video files, but this field |
| # is present whether a video file or another type of file was uploaded. |
| "fileSize": "A String", # The uploaded file's size in bytes. This field is present whether |
| # a video file or another type of file was uploaded. |
| "container": "A String", # The uploaded video file's container format. |
| "creationTime": "A String", # The date and time when the uploaded video file was created. The value is |
| # specified in <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601</a> |
| # format. Currently, the following ISO 8601 formats are supported: |
| # <ul> |
| # <li>Date only: <code>YYYY-MM-DD</code></li> |
| # <li>Naive time: <code>YYYY-MM-DDTHH:MM:SS</code></li> |
| # <li>Time with timezone: <code>YYYY-MM-DDTHH:MM:SS+HH:MM</code></li> |
| # </ul> |
| }, |
| "ageGating": { # Age restriction details related to a video. This data can only be retrieved |
| # by the video owner. |
| "videoGameRating": "A String", # Video game rating, if any. |
| "alcoholContent": True or False, # Indicates whether or not the video has alcoholic beverage content. Only |
| # users of legal purchasing age in a particular country, as identified by |
| # ICAP, can view the content. |
| "restricted": True or False, # Age-restricted trailers. For redband trailers and adult-rated video-games. |
| # Only users aged 18+ can view the content. The the field is |
| # <code>true</code> the content is restricted to viewers aged 18+. Otherwise |
| # The field won't be present. |
| }, |
| "kind": "youtube#video", # Identifies what kind of resource this is. Value: the fixed string |
| # <code>"youtube#video"</code>. |
| "suggestions": { # Specifies suggestions on how to improve video content, # The <code>suggestions</code> object encapsulates suggestions that identify |
| # opportunities to improve the video quality or the metadata for the uploaded |
| # video. This data can only be retrieved by the video owner. |
| # including encoding hints, tag suggestions, and editor suggestions. |
| "processingHints": [ # A list of suggestions that may improve YouTube's ability to process the |
| # video. |
| "A String", |
| ], |
| "tagSuggestions": [ # A list of keyword tags that could be added to the video's metadata to |
| # increase the likelihood that users will locate your video when searching |
| # or browsing on YouTube. |
| { # A single tag suggestion with it's relevance information. |
| "tag": "A String", # The keyword tag suggested for the video. |
| "categoryRestricts": [ # A set of video categories for which the tag is relevant. You can use this |
| # information to display appropriate tag suggestions based on the video |
| # category that the video uploader associates with the video. By default, |
| # tag suggestions are relevant for all categories if there are no restricts |
| # defined for the keyword. |
| "A String", |
| ], |
| }, |
| ], |
| "processingErrors": [ # A list of errors that will prevent YouTube from successfully processing |
| # the uploaded video video. These errors indicate that, regardless of the |
| # video's current <a href="#processingProgress.processingStatus">processing |
| # status</a>, eventually, that status will almost certainly be |
| # <code>failed</code>. |
| "A String", |
| ], |
| "editorSuggestions": [ # A list of video editing operations that might improve the video quality |
| # or playback experience of the uploaded video. |
| "A String", |
| ], |
| "processingWarnings": [ # A list of reasons why YouTube may have difficulty transcoding the |
| # uploaded video or that might result in an erroneous transcoding. |
| # These warnings are generated before YouTube actually processes the |
| # uploaded video file. In addition, they identify issues that are unlikely |
| # to cause the video processing to fail but that might cause problems |
| # such as sync issues, video artifacts, or a missing audio track. |
| "A String", |
| ], |
| }, |
| }</pre> |
| </div> |
| |
| </body></html> |