Todos los videos subidos mediante el extremo
videos.insert
desde proyectos de API sin verificar creados después del 28 de julio de 2020 estarán restringidos al modo de visualización privada. Para quitar esta restricción, cada proyecto de API debe someterse a una auditoría a fin de verificar el cumplimiento de las Condiciones del Servicio. Consulta el Historial de revisión de la API para obtener más detalles.
Un recurso video
representa un video de YouTube.
Métodos
La API admite los siguientes métodos para los recursos videos
:
- Calificación
- Recupera las calificaciones que el usuario autorizado otorgó a una lista de videos específicos. Pruébala ahora.
- list
- Muestra una lista de videos que coinciden con los parámetros de solicitud a la API. Pruébala ahora.
- insertar
- Sube un video a YouTube y, de manera opcional, define los metadatos del video.
- actualizar
- Actualiza los metadatos de un video. Pruébala ahora.
- borrar
- Borra un video de YouTube. Pruébala ahora.
- rate [tarifa]
- Agrega una calificación de “me gusta” o “no me gusta” a un video o quítale su calificación. Pruébala ahora.
- denunciasdeabuso
- Denuncia un video porque incluye contenido abusivo. Pruébala ahora.
Representación de recursos
En la siguiente estructura JSON, se muestra el formato de un recurso videos
:
{ "kind": "youtube#video", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "tags": [ string ], "categoryId": string, "liveBroadcastContent": string, "defaultLanguage": string, "localized": { "title": string, "description": string }, "defaultAudioLanguage": string }, "contentDetails": { "duration": string, "dimension": string, "definition": string, "caption": string, "licensedContent": boolean, "regionRestriction": { "allowed": [ string ], "blocked": [ string ] }, "contentRating": { "acbRating": string, "agcomRating": string, "anatelRating": string, "bbfcRating": string, "bfvcRating": string, "bmukkRating": string, "catvRating": string, "catvfrRating": string, "cbfcRating": string, "cccRating": string, "cceRating": string, "chfilmRating": string, "chvrsRating": string, "cicfRating": string, "cnaRating": string, "cncRating": string, "csaRating": string, "cscfRating": string, "czfilmRating": string, "djctqRating": string, "djctqRatingReasons": [, string ], "ecbmctRating": string, "eefilmRating": string, "egfilmRating": string, "eirinRating": string, "fcbmRating": string, "fcoRating": string, "fmocRating": string, "fpbRating": string, "fpbRatingReasons": [, string ], "fskRating": string, "grfilmRating": string, "icaaRating": string, "ifcoRating": string, "ilfilmRating": string, "incaaRating": string, "kfcbRating": string, "kijkwijzerRating": string, "kmrbRating": string, "lsfRating": string, "mccaaRating": string, "mccypRating": string, "mcstRating": string, "mdaRating": string, "medietilsynetRating": string, "mekuRating": string, "mibacRating": string, "mocRating": string, "moctwRating": string, "mpaaRating": string, "mpaatRating": string, "mtrcbRating": string, "nbcRating": string, "nbcplRating": string, "nfrcRating": string, "nfvcbRating": string, "nkclvRating": string, "oflcRating": string, "pefilmRating": string, "rcnofRating": string, "resorteviolenciaRating": string, "rtcRating": string, "rteRating": string, "russiaRating": string, "skfilmRating": string, "smaisRating": string, "smsaRating": string, "tvpgRating": string, "ytRating": string }, "projection": string, "hasCustomThumbnail": boolean }, "status": { "uploadStatus": string, "failureReason": string, "rejectionReason": string, "privacyStatus": string, "publishAt": datetime, "license": string, "embeddable": boolean, "publicStatsViewable": boolean, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
Propiedades
La siguiente tabla define las propiedades que aparecen en este recurso:
Propiedades | |
---|---|
kind |
string Identifica el tipo de recurso de la API. El valor será youtube#video . |
etag |
etag La Etag de este recurso. |
id |
string ID que YouTube utiliza para identificar de forma exclusiva el video. |
snippet |
object El objeto snippet contiene detalles básicos sobre el video, como el título, la descripción y la categoría. |
snippet.publishedAt |
datetime Fecha y hora en que se publicó el video. Ten en cuenta que esta hora puede ser diferente a la hora en que se subió el video. Por ejemplo, si se sube un video como privado y posteriormente se lo hace público, esta propiedad especificará el momento en que el video se hizo público. Hay algunos casos especiales:
|
snippet.channelId |
string ID que YouTube utiliza para identificar de forma exclusiva el canal al que se subió el video. |
snippet.title |
string Título del video. El valor de la propiedad tiene una longitud máxima de 100 caracteres y puede contener todos los caracteres UTF-8 válidos, excepto < y >. Debes establecer un valor para esta propiedad si llamas al método videos.update y estás actualizando la parte snippet de un recurso video . |
snippet.description |
string Descripción del video El valor de la propiedad tiene una longitud máxima de 5,000 bytes y puede contener todos los caracteres UTF-8 válidos, excepto < y >. |
snippet.thumbnails |
object Un mapa de imágenes en miniatura asociadas con el video. Para cada objeto en el mapa, la clave es el nombre de la imagen en miniatura, y el valor es un objeto que contiene información adicional sobre la viñeta. |
snippet.thumbnails.(key) |
object Los valores de clave válidos son los siguientes:
|
snippet.thumbnails.(key).url |
string La URL de la imagen. |
snippet.thumbnails.(key).width |
unsigned integer El ancho de la imagen. |
snippet.thumbnails.(key).height |
unsigned integer La altura de la imagen. |
snippet.channelTitle |
string Es el título del canal al que pertenece el video. |
snippet.tags[] |
list Una lista de etiquetas de palabras clave asociadas con el video. Las etiquetas pueden contener espacios. El valor de la propiedad tiene una longitud máxima de 500 caracteres. Ten en cuenta las siguientes reglas sobre la forma en que se calcula el límite de caracteres:
|
snippet.categoryId |
string La categoría de video de YouTube asociada con el video. Debes establecer un valor para esta propiedad si llamas al método videos.update y actualizas la parte snippet de un recurso video . |
snippet.liveBroadcastContent |
string Indica si el video es una transmisión en vivo activa o futura. También es "none" si el video no es una transmisión en vivo activa o futura. Los valores válidos para esta propiedad son los siguientes:
|
snippet.defaultLanguage |
string El idioma del texto en las propiedades snippet.title y snippet.description del recurso video . |
snippet.localized |
object El objeto snippet.localized contiene un título y una descripción localizados del video o el título en el idioma predeterminado de los metadatos del video.
localizations para agregar, actualizar o borrar títulos localizados. |
snippet.localized.title |
string Es el título localizado del video. |
snippet.localized.description |
string Es la descripción localizada del video. |
snippet.defaultAudioLanguage |
string La propiedad default_audio_language especifica el idioma que se habla en la pista de audio predeterminada del video. |
contentDetails |
object El objeto contentDetails contiene información sobre el contenido del video, incluida la duración del video y una indicación de si hay subtítulos disponibles para el video. |
contentDetails.duration |
string La duración del video. El valor de la propiedad es una duración ISO 8601. Por ejemplo, para un video que dura al menos un minuto y menos de una hora, la duración tiene el formato PT#M#S , en el que las letras PT indican que el valor especifica un período y las letras M y S hacen referencia a la duración en minutos y segundos, respectivamente. Los caracteres # que preceden a las letras M y S son números enteros que especifican la cantidad de minutos (o segundos) del video. Por ejemplo, un valor de PT15M33S indica que el video dura 15 minutos y 33 segundos.Si el video tiene una duración de, al menos, una hora, tendrá el formato PT#H#M#S , en el que la # que antecede a la letra H especifica la duración del video en horas y todos los demás detalles son los mismos que se describieron anteriormente. Si el video dura al menos un día, las letras P y T se separan, y el formato del valor es P#DT#H#M#S . Consulta la especificación ISO 8601 para obtener todos los detalles. |
contentDetails.dimension |
string Indica si el video está disponible en 3D o en 2D. |
contentDetails.definition |
string Indica si el video está disponible en alta definición ( HD ) o solo en definición estándar.Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.caption |
string Indica si hay subtítulos disponibles para el video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.licensedContent |
boolean Indica si el video representa contenido con licencia, lo que significa que el contenido se subió a un canal vinculado a un socio de contenido de YouTube y, luego, este lo reclamó. |
contentDetails.regionRestriction |
object El objeto regionRestriction contiene información sobre los países donde se puede (o no es) ver un video. El objeto contendrá las propiedades contentDetails.regionRestriction.allowed o contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list Una lista de códigos regionales que identifica los países donde se puede ver el video. Si esta propiedad está presente y un país no se encuentra en su valor, entonces el video está bloqueado en ese país. Si esta propiedad está presente y contiene una lista vacía, el video está bloqueado en todos los países. |
contentDetails.regionRestriction.blocked[] |
list Una lista de códigos regionales que identifica los países donde se bloqueó el video. Si esta propiedad está presente y un país no se encuentra en su valor, entonces el video se puede ver en ese país. Si esta propiedad está presente y contiene una lista vacía, el video se puede ver en todos los países. |
contentDetails.contentRating |
object Especifica las clasificaciones que recibió el video en varios esquemas de clasificación. |
contentDetails.contentRating.acbRating |
string Clasificación de la Australian Classification Board (ACB) o la Australian Communications and Media Authority (ACMA) del video. Las clasificaciones de la ACMA se usan para clasificar la programación de televisión infantil. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.agcomRating |
string La calificación del video es de la Autorità per le Garanzie nelle Comunicazioni (AGCOM) de Italia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.anatelRating |
string La calificación del video Anatel (Asociación Nacional de Televisión) para la televisión chilena Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.bbfcRating |
string La calificación del British Board of Film Classification (BBFC) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.bfvcRating |
string La calificación del video según la Junta de Censores de Películas y Video de Tailandia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.bmukkRating |
string La calificación del video emitida por el Austrian Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur) Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.catvRating |
string Sistema de clasificación para TV canadiense: Sistema de clasificación de TV canadiense La calificación del video de la Comisión Canadiense de Radiotelevisión y Telecomunicaciones (CRTC) para transmisiones en inglés de Canadá. Para obtener más información, consulta el sitio web del Canadian Broadcast Standards Council. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.catvfrRating |
string La calificación del video de la Comisión Canadiense de RadioTelevisión y Telecomunicaciones (CRTC) para las transmisiones en francés de Canadá. Para obtener más información, consulta el sitio web del Canadian Broadcast Standards Council. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cbfcRating |
string La calificación de Central Board of Film Certification (CBFC - India) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cccRating |
string El Consejo de Calificación Cinematográfica (Chile) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cceRating |
string La calificación del video según la Comissão de Classificação de Espect 'culos de Portugal. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.chfilmRating |
string La calificación del video en Suiza. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.chvrsRating |
string La calificación del Canadian Home Video Rating System (CHVRS) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cicfRating |
string La calificación del video de la Commission de Contrôle des Films (Bélgica). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cnaRating |
string La calificación del video corresponde a la CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) de Rumania. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cncRating |
string Sistema de clasificación de Francia: Comisión de clasificación cinematográfica Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.csaRating |
string La calificación del video según el Conseil supérieur de l?audiovisuel de Francia, que califica el contenido de la transmisión. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.cscfRating |
string La calificación del video de la Comisión de vigilancia de la Clasificación de Películas (CSCF) de Luxemburgo Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.czfilmRating |
string La calificación del video en la República Checa. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.djctqRating |
string La calificación del Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Motivos que explican por qué el video recibió la calificación del DJCQT (Brasil) |
contentDetails.contentRating.ecbmctRating |
string Sistema de clasificación de Turquía: Junta de Evaluación y Clasificación del Ministerio de Cultura y Turismo Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.eefilmRating |
string La calificación del video para Estonia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.egfilmRating |
string La calificación del video en Egipto. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.eirinRating |
string Calificación de Eirin (映倫) del video. Eirin es el sistema de calificación japonés. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.fcbmRating |
string La calificación del video según la Junta de Censura de Películas de Malasia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.fcoRating |
string La calificación del video otorgada por la Oficina de Cine, Periódico y Administración de Artículos de Hong Kong. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.fmocRating |
string Esta propiedad dejó de estar disponible el 2 de noviembre de 2015. En su lugar, usa la propiedad contentDetails.contentRating.cncRating .La clasificación Centre National du cinéma et de l'image animé (Ministerio de Cultura de Francia) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.fpbRating |
string La calificación del video emitida por el Consejo de Cine y Publicación de Sudáfrica. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Razones que explican por qué el video recibió la calificación de la FPB (Sudáfrica) |
contentDetails.contentRating.fskRating |
string La calificación Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Alemania) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.grfilmRating |
string La calificación del video en Grecia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.icaaRating |
string La calificación del Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - España) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.ifcoRating |
string Calificación de Ireland Film Classification Office (IFCO - Ireland) del video. Consulta el sitio web de IFCO para obtener más información. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.ilfilmRating |
string La calificación del video en Israel. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.incaaRating |
string La clasificación INCAA (Instituto Nacional de Cine y Artes Audiovisuales, Argentina) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.kfcbRating |
string Calificación del video emitida por Kenia Film Classification Board. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Países Bajos). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.kmrbRating |
string Calificación de Korea Media Rating Board (영물등品型는) del video. El KMRB califica los videos de Corea del Sur. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.lsfRating |
string La calificación del video corresponde a la película indonesia Lembaga Sensor Film. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mccaaRating |
string La calificación del video emitida por el Film Age-Classification Board de Malta. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mccypRating |
string La calificación del video del Danish Film Institute (Det Danske Filminstitut) Media Council for Children and Young People Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mcstRating |
string El sistema de clasificación del video para Vietnam - MCST Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mdaRating |
string La calificación del video que otorga la Autoridad de Desarrollo de Medios (MDA) de Singapur y, en particular, la Junta de Censores de Películas (BFC). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.medietilsynetRating |
string La calificación del video proveniente de Medietilsynet, la Autoridad de Medios de Noruega. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mekuRating |
string La calificación del video proporcionada por el Kansallinen Audiovisuaalinen Instituutti (Instituto Audiovisual Nacional) de Finlandia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mibacRating |
string La calificación del video del Ministero dei Beni e delle Attività Culturali e del Turismo (Italia). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mocRating |
string La calificación del Ministerio de Cultura (Colombia) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.moctwRating |
string La calificación del video que otorga el Ministerio de Cultura de Taiwán (文化部). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mpaaRating |
string La clasificación de la Asociación Cinematográfica de Estados Unidos (MPAA) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mpaatRating |
string La calificación de la Asociación Cinematográfica de Estados Unidos en cuanto a avances y vistas previas de películas. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.mtrcbRating |
string La calificación del video según la Junta de Revisión y Clasificación de Películas y Televisión (Filipinas). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.nbcRating |
string La calificación del video otorgada por la Oficina Nacional de Clasificación de las Maldivas. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.nfrcRating |
string La calificación del video según el Bulgarian National Film Center. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.nfvcbRating |
string La calificación del video emitida por la National Film and Video Censors Board de Nigeria. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.nkclvRating |
string La calificación del video proveniente del Nacionãlais Kino centrs (Centro Nacional de Cine de Letonia). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.oflcRating |
string Calificación de la Office of Film and Literature Classification (OFLC - Nueva Zelanda) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.pefilmRating |
string La calificación del video en Perú. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.resorteviolenciaRating |
string La calificación del video en Venezuela. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.rtcRating |
string La calificación de la Dirección General de Radio, Televisión y Cinematografía (México) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.rteRating |
string La calificación del video según el canal irlandés Raidió Teilifís Éireann. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.russiaRating |
string Calificación del Registro Nacional de Películas de la Federación Rusa (MKRF - Rusia) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.skfilmRating |
string La calificación del video en Eslovaquia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.smaisRating |
string La calificación del video en Islandia. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.smsaRating |
string La calificación del video según el Statens medieråd (Consejo Nacional de Medios de Suecia). Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.tvpgRating |
string La calificación TV Parental Guidelines (TVPG) del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.contentRating.ytRating |
string Clasificación que YouTube usa para identificar contenido con restricción de edad. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.projection |
string Especifica el formato de proyección del video. Los valores válidos para esta propiedad son los siguientes:
|
contentDetails.hasCustomThumbnail |
boolean Indica si quien subió el video proporcionó una imagen en miniatura personalizada. Esta propiedad solo es visible para la persona que sube el video. |
status |
object El objeto status contiene información sobre la carga, el procesamiento y los estados de privacidad del video. |
status.uploadStatus |
string El estado del video que se subió. Los valores válidos para esta propiedad son los siguientes:
|
status.failureReason |
string Este valor explica por qué no se pudo subir un video. Esta propiedad solo está presente si la propiedad uploadStatus indica que la carga falló.Los valores válidos para esta propiedad son los siguientes:
|
status.rejectionReason |
string Este valor explica por qué YouTube rechazó un video que se subió. Esta propiedad solo está presente si la propiedad uploadStatus indica que se rechazó la carga.Los valores válidos para esta propiedad son los siguientes:
|
status.privacyStatus |
string El estado de privacidad del video. Los valores válidos para esta propiedad son los siguientes:
|
status.publishAt |
datetime Es la fecha y la hora en que se programó la publicación del video. Solo se puede establecer si el estado de privacidad del video es privado. El valor se especifica en el formato ISO 8601. Ten en cuenta los siguientes dos puntos adicionales sobre el comportamiento de esta propiedad:
|
status.license |
string La licencia del video. Los valores válidos para esta propiedad son los siguientes:
|
status.embeddable |
boolean Este valor indica si el video se puede incorporar en otro sitio web. |
status.publicStatsViewable |
boolean Este valor indica si las estadísticas extendidas del video en la página de reproducción del video son visibles de forma pública. De forma predeterminada, estas estadísticas se pueden ver, y otras estadísticas, como el recuento de vistas y las calificaciones de un video, seguirán siendo visibles para el público, incluso si el valor de esta propiedad se establece en false . |
status.madeForKids |
boolean Este valor indica si el video está designado como contenido dirigido a niños y si contiene el estado actual de “creado para niños”. Por ejemplo, el estado podría determinarse según el valor de la propiedad selfDeclaredMadeForKids . Consulta el Centro de ayuda de YouTube para obtener más información sobre cómo configurar el público de tu canal, tus videos o tus transmisiones.
|
status.selfDeclaredMadeForKids |
boolean En una solicitud videos.insert o videos.update , esta propiedad permite que el propietario del canal designe el video como dirigido a niños. En una solicitud videos.list , el valor de la propiedad solo se muestra si el propietario del canal autorizó la solicitud a la API. |
statistics |
object El objeto statistics contiene estadísticas sobre el video. |
statistics.viewCount |
unsigned long Es la cantidad de veces que se miró el video. |
statistics.likeCount |
unsigned long La cantidad de usuarios que indicaron que les gustó el video. |
statistics.dislikeCount |
unsigned long Nota: La propiedad
statistics.dislikeCount pasó a ser privada el 13 de diciembre de 2021. Esto significa que la propiedad se incluye en una respuesta de la API solo si el propietario del video autenticó la solicitud a la API. Consulta el historial de revisión para obtener más información.Cantidad de usuarios que indicaron que no les gustó el video. |
statistics.favoriteCount |
unsigned long Nota: Esta propiedad dejó de estar disponible. La baja entrará en vigencia el 28 de agosto de 2015. El valor de la propiedad ahora siempre se establece en 0 . |
statistics.commentCount |
unsigned long La cantidad de comentarios en el video. |
player |
object El objeto player contiene información que puedes usar para reproducir el video en un reproductor incorporado. |
player.embedHtml |
string Una etiqueta <iframe> que incorpora un reproductor que reproduce el video.
|
player.embedHeight |
long Es la altura del reproductor incorporado que se muestra en la propiedad player.embedHtml . Esta propiedad solo se muestra si la solicitud especificó un valor para los parámetros maxHeight o maxWidth , y se conoce la relación de aspecto del video. |
player.embedWidth |
long Es el ancho del reproductor incorporado que se muestra en la propiedad player.embedHtml . Esta propiedad solo se muestra si la solicitud especificó un valor para los parámetros maxHeight o maxWidth , y se conoce la relación de aspecto del video. |
topicDetails |
object El objeto topicDetails contiene información sobre temas asociados con el video.Importante: Consulta las definiciones de las propiedades topicDetails.relevantTopicIds[] y topicDetails.topicIds[] , así como el historial de revisión para obtener más detalles sobre los próximos cambios relacionados con los IDs de los temas. |
topicDetails.topicIds[] |
list Importante: Esta propiedad dejó de estar disponible el 10 de noviembre de 2016. La API ya no muestra valores para esta propiedad, y el valor de propiedad topicDetails.relevantTopicIds[] ahora muestra cualquier tema asociado con un video. |
topicDetails.relevantTopicIds[] |
list Una lista de los IDs de tema que son relevantes para el video. Esta propiedad dejó de estar disponible el 10 de noviembre de 2016. Estará disponible hasta el 10 de noviembre de 2017. Importante: Debido a que Freebase y su API de Freebase dejaron de estar disponibles, los IDs de tema comenzaron a funcionar de manera diferente a partir del 27 de febrero de 2017. En ese momento, YouTube comenzó a mostrar un pequeño conjunto de ID de temas seleccionados. |
topicDetails.topicCategories[] |
list Una lista de URLs de Wikipedia que proporcionan una descripción de alto nivel del contenido del video. |
recordingDetails |
object El objeto recordingDetails contiene información sobre la ubicación, fecha y dirección donde se grabó el video. |
recordingDetails.locationDescription |
string Esta propiedad dejó de estar disponible el 1 de junio de 2017. Consulta el anuncio de baja para obtener más detalles. Es la descripción de texto de la ubicación donde se grabó el video. |
recordingDetails.location |
object La información de ubicación geográfica asociada con el video. Ten en cuenta que los valores de la propiedad secundaria identifican la ubicación que el propietario del video quiere asociar con el video. El valor se puede editar, buscar en los videos públicos y se podría mostrar a los usuarios en los videos públicos. |
recordingDetails.location.latitude |
double Esta propiedad dejó de estar disponible el 1 de junio de 2017. Consulta el anuncio de baja para obtener más detalles. Latitud en grados. |
recordingDetails.location.longitude |
double Esta propiedad dejó de estar disponible el 1 de junio de 2017. Consulta el anuncio de baja para obtener más detalles. Longitud en grados. |
recordingDetails.location.altitude |
double Esta propiedad dejó de estar disponible el 9 de julio de 2018. Consulta el anuncio de baja para obtener más detalles. Altitud sobre el elipsoide de referencia, en metros. |
recordingDetails.recordingDate |
datetime Fecha y hora en que se grabó el video. El valor se especifica en formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ). |
fileDetails |
object El objeto fileDetails contiene información sobre el archivo de video que se subió a YouTube, como la resolución, la duración, los códecs de audio y video del archivo, las tasas de bits de transmisión y mucho más. Solamente el propietario del video puede recuperar estos datos.El objeto fileDetails solo se mostrará si la propiedad processingDetails.fileAvailability tiene un valor de available . |
fileDetails.fileName |
string El nombre del archivo que se subió. Este campo está presente si se subió un archivo de video u otro tipo de archivo. |
fileDetails.fileSize |
unsigned long Corresponde al tamaño en bytes del archivo que se subió. Este campo está presente si se subió un archivo de video u otro tipo de archivo. |
fileDetails.fileType |
string Es el tipo de archivo que se subió, según lo detecta el motor de procesamiento de videos de YouTube. Actualmente, YouTube solo procesa archivos de video, pero este campo está presente independientemente de si se subió un archivo de video o de otro tipo de archivo. Los valores válidos para esta propiedad son los siguientes:
|
fileDetails.container |
string Formato contenedor del archivo de video que se subió. |
fileDetails.videoStreams[] |
list Es una lista de transmisiones de video por Internet que contiene el archivo de video que se subió. Cada elemento de la lista contiene metadatos detallados sobre una transmisión continua de video. |
fileDetails.videoStreams[].widthPixels |
unsigned integer Es el ancho en píxeles del contenido de video codificado. Puedes calcular la relación de aspecto de codificación del video como width_pixels / height_pixels . |
fileDetails.videoStreams[].heightPixels |
unsigned integer Altura en píxeles del contenido de video codificado. |
fileDetails.videoStreams[].frameRateFps |
double Velocidad de fotogramas de la transmisión de video por Internet, en fotogramas por segundo. |
fileDetails.videoStreams[].aspectRatio |
double La relación de aspecto de la pantalla del contenido de video, que especifica la relación de aspecto en la que se debe mostrar el video. |
fileDetails.videoStreams[].codec |
string Códec de video que usa la transmisión continua. |
fileDetails.videoStreams[].bitrateBps |
unsigned long Tasa de bits de la transmisión de video por Internet, en bits por segundo. |
fileDetails.videoStreams[].rotation |
string La cantidad que YouTube necesita para rotar el contenido original a fin de mostrar correctamente el video. Los valores válidos para esta propiedad son los siguientes:
|
fileDetails.videoStreams[].vendor |
string Es un valor que identifica de forma única a un proveedor de videos. Normalmente, el valor es un código de proveedor de cuatro letras. |
fileDetails.audioStreams[] |
list Es una lista de transmisiones de audio que contiene el archivo de video que se subió. Cada elemento de la lista contiene metadatos detallados sobre una transmisión continua de audio. |
fileDetails.audioStreams[].channelCount |
unsigned integer Es la cantidad de canales de audio que contiene la transmisión. |
fileDetails.audioStreams[].codec |
string Códec de audio que usa la transmisión. |
fileDetails.audioStreams[].bitrateBps |
unsigned long La tasa de bits de la transmisión de audio, en bits por segundo. |
fileDetails.audioStreams[].vendor |
string Es un valor que identifica de forma única a un proveedor de videos. Normalmente, el valor es un código de proveedor de cuatro letras. |
fileDetails.durationMs |
unsigned long Es la duración del video que se subió, expresada en milisegundos. |
fileDetails.bitrateBps |
unsigned long La tasa de bits combinada (video y audio) del archivo de video que se subió, en bits por segundo. |
fileDetails.creationTime |
string Fecha y hora en que se creó el archivo de video que se subió. El valor se especifica en el formato ISO 8601. Actualmente, se admiten los siguientes formatos ISO 8601:
|
processingDetails |
object El objeto processingDetails contiene información sobre el progreso de YouTube en el procesamiento del archivo de video subido. Las propiedades del objeto identifican el estado actual del proceso y una estimación del tiempo restante hasta que YouTube termine de procesar el video. Esta parte también indica si los diferentes tipos de datos o contenido, como detalles de los archivos o las imágenes en miniatura, están disponibles para el video.El objeto processingProgress está diseñado para que se sondee, de modo que el video subido pueda hacer un seguimiento del progreso que YouTube ha hecho en el procesamiento del archivo de video subido. Solamente el propietario del video puede recuperar estos datos. |
processingDetails.processingStatus |
string Estado de procesamiento del video. Este valor indica si YouTube pudo procesar el video o si este aún se está procesando. Los valores válidos para esta propiedad son los siguientes:
|
processingDetails.processingProgress |
object El objeto processingProgress contiene información sobre el progreso de YouTube en el procesamiento del video. Los valores solo son relevantes si el estado de procesamiento del video es processing . |
processingDetails.processingProgress.partsTotal |
unsigned long Una estimación de la cantidad total de partes que se deben procesar para el video. El número se puede actualizar con estimaciones más precisas, mientras YouTube procesa el video. |
processingDetails.processingProgress.partsProcessed |
unsigned long Es la cantidad de partes del video que YouTube ya procesó. Para calcular el porcentaje del video que YouTube ya procesó, es posible que el progreso calculado disminuya periódicamente mientras YouTube procesa un video, ya que es posible que aumente la cantidad estimada de partes sin que se produzca un aumento correspondiente de la cantidad de partes que ya se procesaron. 100 * parts_processed / parts_total |
processingDetails.processingProgress.timeLeftMs |
unsigned long Una estimación del tiempo, en milisegundos, que YouTube necesita para terminar de procesar el video. |
processingDetails.processingFailureReason |
string El motivo por el que YouTube no pudo procesar el video. Esta propiedad solo tendrá un valor si el valor de la propiedad processingStatus es failed .Los valores válidos para esta propiedad son los siguientes:
|
processingDetails.fileDetailsAvailability |
string Este valor indica si los detalles de los archivos están disponibles para el video que se subió. Para recuperar los detalles de un archivo de video, solicita la parte fileDetails en tu solicitud videos.list() . |
processingDetails.processingIssuesAvailability |
string Este valor indica si el motor de procesamiento de videos generó sugerencias que podrían mejorar la capacidad de YouTube para procesar el video, advertencias que explican los problemas de procesamiento del video o errores que causan problemas de procesamiento. Para recuperar estas sugerencias, solicita la parte suggestions en tu solicitud videos.list() . |
processingDetails.tagSuggestionsAvailability |
string Este valor indica si las sugerencias de palabras clave (etiquetas) están disponibles para el video. Las etiquetas se pueden agregar a los metadatos de un video para que los demás usuarios puedan encontrar más fácilmente el video. Para recuperar estas sugerencias, solicita la parte suggestions en tu solicitud videos.list() . |
processingDetails.editorSuggestionsAvailability |
string Este valor indica si las sugerencias de edición de video, que podrían mejorar la calidad del video o la experiencia de reproducción, están disponibles para el video. Para recuperar estas sugerencias, solicita la parte suggestions en tu solicitud videos.list() . |
processingDetails.thumbnailsAvailability |
string Este valor indica si se generaron imágenes en miniatura para el video. |
suggestions |
object El objeto suggestions contiene sugerencias que identifican oportunidades para mejorar la calidad del video o sus metadatos. Solamente el propietario del video puede recuperar estos datos. El objeto suggestions solo se mostrará si las propiedades processingDetails.tagSuggestionsAvailability o processingDetails.editorSuggestionsAvailability tienen un valor de available . |
suggestions.processingErrors[] |
list Una lista de los errores que impedirán que YouTube procese correctamente el video que se subió. Estos errores indican que, independientemente del estado de procesamiento actual del video, en algún momento, ese estado será failed .Los valores válidos para esta propiedad son los siguientes:
|
suggestions.processingWarnings[] |
list Una lista de los motivos por los que YouTube puede tener dificultades para transcodificar el video subido o que podrían generar un error de transcodificación Estas advertencias se generan antes de que YouTube procese el archivo de video que se subió. Además, identifican problemas que no necesariamente indican que fallará el procesamiento del video, pero que aún podrían causar inconvenientes, como inconvenientes de sincronización, artefactos de video o una pista de audio faltante. Los valores válidos para esta propiedad son los siguientes:
|
suggestions.processingHints[] |
list Esta es una lista de sugerencias que podrían mejorar la capacidad de YouTube para procesar el video. Los valores válidos para esta propiedad son los siguientes:
|
suggestions.tagSuggestions[] |
list Una lista de etiquetas de palabras clave que se podrían agregar a los metadatos del video para aumentar la probabilidad de que los usuarios encuentren tu video cuando busquen o exploren en YouTube |
suggestions.tagSuggestions[].tag |
string Es la etiqueta de palabra clave sugerida para el video. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Un conjunto de categorías de video para el que la etiqueta es relevante. Se puede utilizar esta información para mostrar sugerencias de etiquetas adecuadas, según la categoría de video que el usuario que sube el video asocia con este. De forma predeterminada, las sugerencias de etiquetas son pertinentes para todas las categorías si no hay restricciones definidas para la palabra clave. |
suggestions.editorSuggestions[] |
list Una lista de operaciones de edición de video que podrían mejorar la calidad del video o la experiencia de reproducción del video subido. Los valores válidos para esta propiedad son los siguientes:
|
liveStreamingDetails |
object El objeto liveStreamingDetails contiene metadatos sobre una transmisión de video en vivo. El objeto solo estará presente en un recurso video si el video es una próxima transmisión, en vivo o se completó. |
liveStreamingDetails.actualStartTime |
datetime Hora en que comenzó realmente la transmisión. El valor se especifica en el formato ISO 8601. Este valor no estará disponible hasta que comience la transmisión. |
liveStreamingDetails.actualEndTime |
datetime Hora en que finalizó la transmisión. El valor se especifica en el formato ISO 8601. Este valor no estará disponible hasta que finalice la transmisión. |
liveStreamingDetails.scheduledStartTime |
datetime Es la hora a la que está programada el inicio de la transmisión. El valor se especifica en el formato ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetime Es la hora a la que está programada la finalización de la transmisión. El valor se especifica en el formato ISO 8601. Si el valor está vacío o la propiedad no está presente, la transmisión está programada para continuar indefinidamente. |
liveStreamingDetails.concurrentViewers |
unsigned long Es la cantidad de usuarios que están mirando la transmisión en ese momento. La propiedad y su valor estarán presentes si la transmisión tiene espectadores actuales y el propietario de la transmisión no ocultó el recuento de vistas del video. Ten en cuenta que YouTube deja de rastrear la cantidad de espectadores simultáneos de una transmisión cuando esta finaliza. Por lo tanto, esta propiedad no identificaría la cantidad de usuarios que miran un video archivado de una transmisión en vivo que ya finalizó. Los recuentos de usuarios simultáneos que muestra la API de datos de YouTube pueden diferir de los recuentos de usuarios simultáneos procesados y sin spam disponibles en YouTube Analytics. Obtén más información sobre las métricas de las transmisiones en vivo en el Centro de ayuda de YouTube.
|
liveStreamingDetails.activeLiveChatId |
string Es el ID del chat en vivo activo que se encuentra adjunto a este video. Este campo se completa solo si el video es una transmisión en vivo que tiene chat en vivo. Cuando la transmisión finalice, se quitará este campo y se cerrará el chat en vivo. Para las transmisiones persistentes, el ID del chat en vivo ya no estará vinculado a este video, sino al video nuevo que se mostrará en la página persistente. |
localizations |
object El objeto localizations contiene traducciones de los metadatos del video. |
localizations.(key) |
object Corresponde al idioma del texto localizado asociado con el par clave-valor. El valor es una string que contiene un código de idioma BCP-47. |
localizations.(key).title |
string Es el título localizado del video. |
localizations.(key).description |
string Es la descripción localizada del video. |