Un recurso video
representa un video de YouTube.
Métodos
La API admite los siguientes métodos para los recursos de videos
:
- getRating
- Recupera las calificaciones que el usuario autorizado otorgó a una lista de videos específicos. Pruébalo ahora.
- list
- Muestra una lista de los videos que coinciden con los parámetros de solicitud de la API. Pruébalo ahora.
- insert
- Sube un video a YouTube y configura opcionalmente sus metadatos.
- update
- Actualiza los metadatos de un video. Pruébalo ahora.
- delete
- Elimina un video de YouTube. Pruébalo ahora.
- rate
- Agrega una calificación "me gusta" o "no me gusta" a un video o elimina la calificación de un video. Pruébalo ahora.
Representación de recursos
La estructura JSON a continuación muestra el formato de un recurso de 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 }, "contentDetails": { "duration": string, "dimension": string, "definition": string, "caption": string, "licensedContent": boolean, "regionRestriction": { "allowed": [ string ], "blocked": [ string ] }, "contentRating": { "mpaaRating": string, "tvpgRating": string, "bbfcRating": string, "chvrsRating": string, "eirinRating": string, "cbfcRating": string, "fmocRating": string, "icaaRating": string, "acbRating": string, "oflcRating": string, "fskRating": string, "kmrbRating": string, "djctqRating": string, "russiaRating": string, "rtcRating": string, "ytRating": string } }, "status": { "uploadStatus": string, "failureReason": string, "rejectionReason": string, "privacyStatus": string, "license": string, "embeddable": boolean, "publicStatsViewable": boolean }, "statistics": { "viewCount": unsigned long, "likeCount": unsigned long, "dislikeCount": unsigned long, "favoriteCount": unsigned long, "commentCount": unsigned long }, "player": { "embedHtml": string }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ] }, "recordingDetails": { "locationDescription": string, "location": { "latitude": double, "longitude": double, "altitude": double }, "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, "recordingLocation": { "latitude": double, "longitude": double, "altitude": double }, "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 ] } }
Propiedades
La siguiente tabla define las propiedades que aparecen en este recurso:
Propiedades | |
---|---|
kind |
string Tipo de recurso de la API. El valor será youtube#video . |
etag |
etag Etag de este recurso. |
id |
string ID que YouTube utiliza para identificar de forma exclusiva el video. |
snippet |
object El objeto snippet contiene información básica sobre el video, como el título, la descripción y la categoría. |
snippet.publishedAt |
datetime Fecha y hora en que se subió el video. El valor se especifica en el formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ). |
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. |
snippet.description |
string Descripción del video. |
snippet.thumbnails |
object 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 otra información sobre la viñeta. |
snippet.thumbnails.(key) |
object Los valores de clave válidos son:
|
snippet.thumbnails.(key).url |
string URL de la imagen. |
snippet.thumbnails.(key).width |
unsigned integer Ancho de la imagen. |
snippet.thumbnails.(key).height |
unsigned integer Altura de la imagen. |
snippet.channelTitle |
string Título de canal para el canal al cual pertenece el video. |
snippet.tags[] |
list Lista de etiquetas de palabras clave asociadas con el video. Las etiquetas pueden contener espacios. Este campo es visible solo para quien sube el video. |
snippet.categoryId |
string Categoría de video de YouTube asociada con el video. |
contentDetails |
object El objeto contentDetails contiene información sobre el contenido del video, incluida la duración del mismo y su proporción. |
contentDetails.duration |
string Duración del video. El valor de la etiqueta es una duración ISO 8601 en el formato PT#M#S , en el cual las letras PT indican que el valor especifica un período de tiempo, y las letras M y S se refieren 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 el número de minutos (o segundos) del video. Por ejemplo, un valor de PT15M51S indica que el video dura 15 minutos y 51 segundos. |
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:
|
contentDetails.caption |
string Indica si hay subtítulos disponibles para el video. Los valores válidos para esta propiedad son:
|
contentDetails.licensedContent |
boolean Indica si el video representa contenido con licencia, lo que significa que el contenido ha sido reclamado por un socio de contenido de YouTube. |
contentDetails.regionRestriction |
object El objeto regionRestriction contiene información sobre los países donde es (o no es) posible ver un video. El objeto puede contener la propiedad contentDetails.regionRestriction.allowed o la propiedad contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list Lista de los códigos de región que identifican a los países donde el video se puede ver. 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 Lista de los códigos de región que identifican a los países donde está bloqueado 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 calificaciones que recibió el video en diversos esquemas de calificación. |
contentDetails.contentRating.mpaaRating |
string Calificación del video de la Motion Picture Association of America (MPAA). Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.tvpgRating |
string Calificación de TV Parental Guidelines (TVPG) del video. Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.bbfcRating |
string Calificación de British Board of Film Classification (BBFC) del video. Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.chvrsRating |
string Calificación de Canadian Home Video Rating System (CHVRS) del video. Los valores válidos para esta propiedad son:
|
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:
|
contentDetails.contentRating.cbfcRating |
string Calificación de Central Board of Film Certification (CBFC - India) del video. Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.fmocRating |
string Calificación de 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:
|
contentDetails.contentRating.icaaRating |
string 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:
|
contentDetails.contentRating.acbRating |
string Clasificación de Australian Classification Board (ACB) del video. Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.oflcRating |
string Calificación de Office of Film and Literature Classification (OFLC - Nueva Zelanda) del video. Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.fskRating |
string Calificación de Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Alemania) del video. Los valores válidos para esta propiedad son:
|
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:
|
contentDetails.contentRating.djctqRating |
string 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:
|
contentDetails.contentRating.russiaRating |
string Calificación de la Federación Nacional Rusa de Registro de Películas (MKRF - Rusia) del video. Los valores válidos para esta propiedad son:
|
contentDetails.contentRating.rtcRating |
string 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:
|
contentDetails.contentRating.ytRating |
string Calificación que YouTube utiliza para identificar el contenido con restricciones de edad. Los valores válidos para esta propiedad son:
|
status |
object El objeto status contiene información sobre la subida, el procesamiento y los estados de privacidad del video. |
status.uploadStatus |
string Estado del video subido. Los valores válidos para esta propiedad son:
|
status.failureReason |
string Este valor explica por qué un video no se pudo subir. Esta propiedad solo está presente si la propiedad uploadStatus indica que el video no se pudo subir.Los valores válidos para esta propiedad son:
|
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 el video que se subió fue rechazado.Los valores válidos para esta propiedad son:
|
status.privacyStatus |
string Estado de privacidad del video. Los valores válidos para esta propiedad son:
|
status.license |
string Licencia del video. Los valores válidos para esta propiedad son:
|
status.embeddable |
boolean Este valor indica si el video se puede insertar en otro sitio web. |
status.publicStatsViewable |
boolean Este valor indica si el público puede ver las estadísticas extendidas del video en la página de reproducción del video. De manera predeterminada, estas estadísticas se pueden ver, y otras estadísticas como el número de reproducciones 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 . |
statistics |
object El objeto statistics contiene información sobre el video. |
statistics.viewCount |
unsigned long Cantidad de veces que se ha reproducido el video. |
statistics.likeCount |
unsigned long Número de usuarios que indicaron que les gustó el video, dándole una calificación positiva. |
statistics.dislikeCount |
unsigned long Número de usuarios que indicaron que no les gustó el video, dándole una calificación negativa. |
statistics.favoriteCount |
unsigned long Número de usuarios que actualmente tienen marcado el video como video favorito. |
statistics.commentCount |
unsigned long Número de comentarios del video. |
player |
object El objeto player contiene información que puedes utilizar para reproducir el video en un reproductor insertado. |
player.embedHtml |
string Etiqueta <iframe> que inserta un reproductor que reproducirá el video. |
topicDetails |
object El objeto topicDetails contiene información sobre temas de Freebase relacionados con el video. |
topicDetails.topicIds[] |
list Lista de ID de temas de Freebase que están asociados de manera central con el video. Estos son temas que se destacan en el video, y se puede decir que el video se trata principalmente acerca de cada uno de ellos. Para obtener información sobre cada tema, usa la API de temas de Freebase. |
topicDetails.relevantTopicIds[] |
list Similar a topic_id, excepto que estos temas solo son pertinentes para el video. Estos son temas que se pueden mencionar o aparecen en el video. Para obtener información sobre cada tema, usa la API de temas de Freebase. |
recordingDetails |
object El objeto recordingDetails contiene información sobre la ubicación, fecha y dirección donde se grabó el video. |
recordingDetails.locationDescription |
string Descripción de texto de la ubicación en la que se grabó el video. |
recordingDetails.location |
object Información de localización geográfica asociada con el video. |
recordingDetails.location.latitude |
double Latitud en grados. |
recordingDetails.location.longitude |
double Longitud en grados. |
recordingDetails.location.altitude |
double 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 el formato ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ). |
fileDetails |
object El objeto fileDetails contiene información sobre el archivo de video que se subió a YouTube, tal como la resolución del archivo, la duración, el audio y los codecs de video, las velocidades de bits de transmisión y más. Estos datos solamente los puede recuperar el propietario del video. |
fileDetails.fileName |
string 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 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 Tipo de archivo que se subió, según lo que detectó el motor de procesamiento de videos de YouTube. Aunque YouTube solo procesa archivos de video en este momento, este campo está presente si se subió un archivo de video u otro tipo de archivo. Los valores válidos para esta propiedad son:
|
fileDetails.container |
string Formato contenedor del archivo de video que se subió. |
fileDetails.videoStreams[] |
list Lista de transmisiones continuas de video 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 Ancho en píxeles del contenido de video codificado. Se puede calcular la proporción 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 continua de video, medida en fotogramas por segundo. |
fileDetails.videoStreams[].aspectRatio |
double Relación de aspecto de la pantalla del contenido de video, que especifica la proporción en la que se debe mostrar el video. |
fileDetails.videoStreams[].codec |
string Códec de video que utiliza la transmisión continua. |
fileDetails.videoStreams[].bitrateBps |
unsigned long Velocidad de bits de la transmisión continua de video, medida en bits por segundo. |
fileDetails.videoStreams[].rotation |
string Medida que YouTube tiene que considerar para girar el contenido de la fuente original con el fin de mostrar correctamente el video. Los valores válidos para esta propiedad son:
|
fileDetails.videoStreams[].vendor |
string Valor que identifica de forma exclusiva a un proveedor de video. Normalmente, el valor es un código de proveedor de cuatro letras. |
fileDetails.audioStreams[] |
list Lista de transmisiones continuas 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 Número de canales de audio que contiene la transmisión continua. |
fileDetails.audioStreams[].codec |
string Códec de audio que utiliza la transmisión continua. |
fileDetails.audioStreams[].bitrateBps |
unsigned long Velocidad de bits de la transmisión continua de audio, medida en bits por segundo. |
fileDetails.audioStreams[].vendor |
string Valor que identifica de forma exclusiva a un proveedor de video. Normalmente, el valor es un código de proveedor de cuatro letras. |
fileDetails.durationMs |
unsigned long Duración en milisegundos del video que se subió. |
fileDetails.bitrateBps |
unsigned long Velocidad de bits combinada (video y audio) del archivo de video que se subió, medida en bits por segundo. |
fileDetails.recordingLocation |
object Coordenadas geográficas que identifican el lugar donde se grabó el video que se subió. Las coordenadas se definen mediante WGS 84. |
fileDetails.recordingLocation.latitude |
double Latitud en grados. |
fileDetails.recordingLocation.longitude |
double Longitud en grados. |
fileDetails.recordingLocation.altitude |
double Altitud sobre el elipsoide de referencia, en metros. |
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 processingProgress contiene información sobre el progreso de YouTube en el procesamiento del archivo de video que se subió. 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 someterse a sondeo, a fin de que el video subido realice un seguimiento del progreso de YouTube en el procesamiento del archivo de video que se subió. Estos datos solamente los puede recuperar el propietario del video. |
processingDetails.processingStatus |
string Estado de procesamiento del video. Este valor indica si YouTube pudo procesar el video o si el video aún se está procesando. Los valores válidos para esta propiedad son:
|
processingDetails.processingProgress |
object El objeto processingProgress contiene información sobre el progreso de YouTube en el procesamiento del archivo de video que se subió. Los valores son pertinentes solo si el estado de procesamiento del video es processing . |
processingDetails.processingProgress.partsTotal |
unsigned long Estimación del número 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 Número de partes del video que YouTube ya ha procesado. Se puede calcular el porcentaje del video que YouTube ha procesado mediante la siguiente operación: 100 * parts_processed / parts_total Ten en cuenta que, dado que el número estimado de partes podría aumentar sin que se produzca un aumento correspondiente en el número de piezas que ya se han procesado, es posible que el progreso calculado disminuya periódicamente mientras YouTube procesa un video. |
processingDetails.processingProgress.timeLeftMs |
unsigned long Estimación del tiempo, en milisegundos, que YouTube necesita para terminar de procesar el video. |
processingDetails.processingFailureReason |
string Razón por la 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:
|
processingDetails.fileDetailsAvailability |
string Este valor indica si los detalles de los archivos están disponibles para el video que se subió. Para recuperar detalles de un archivo de video, solicita la parte fileDetails en tu solicitud de videos.list() . |
processingDetails.processingIssuesAvailability |
string Este valor indica si el motor de procesamiento de videos ha generado sugerencias que podrían mejorar la capacidad de YouTube para procesar el video, advertencias que explican los problemas de procesamiento de videos, o errores que causan problemas de procesamiento de videos. Para recuperar estas sugerencias, solicita la parte suggestions en tu solicitud de 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 de 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 de la experiencia de reproducción, están disponibles para el video. Para recuperar estas sugerencias, solicita la parte suggestions en tu solicitud de videos.list() . |
processingDetails.thumbnailsAvailability |
string Este valor indica si se generaron las imágenes en miniatura para el video. |
suggestions |
object El objeto suggestions contiene sugerencias que identifican oportunidades para mejorar la calidad de los videos o los metadatos del video que se subió. Solamente el propietario del video puede recuperar estos datos. |
suggestions.processingErrors[] |
list 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, es casi seguro que el estado finalmente será failed .Los valores válidos para esta propiedad son:
|
suggestions.processingWarnings[] |
list Lista de razones por las que YouTube puede tener dificultades para transcodificar el video que se subió o que puedan causar 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 el video no se podrá procesar, pero que aún pueden causar inconvenientes, como problemas de sincronización, artefactos de video o la ausencia de una pista de audio. Los valores válidos para esta propiedad son:
|
suggestions.processingHints[] |
list Lista de sugerencias que pueden mejorar la capacidad de YouTube para procesar el video. Los valores válidos para esta propiedad son:
|
suggestions.tagSuggestions[] |
list Lista de las etiquetas de palabras clave que se podrían agregar a los metadatos del video para aumentar las probabilidades de que los usuarios localicen tu video cuando busquen o exploren en YouTube. |
suggestions.tagSuggestions[].tag |
string Etiqueta de palabra clave sugerida para el video. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Conjunto de categorías de video para el cual la etiqueta es pertinente. 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 Lista de operaciones de edición de video que podrían mejorar la calidad del video o de la experiencia de reproducción del video que se subió. Los valores válidos para esta propiedad son:
|