Videos

Un recurso video representa un vide­o 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:
  • default: Imagen en miniatura predeterminada. La viñeta predeterminada para un video, o de un recurso que hace referencia a un video, como un elemento de una lista de reproducción o el resultado de una búsqueda, es de 120 pixeles de ancho y 90 píxeles de alto. La viñeta predeterminada para un canal es de 88 píxeles de ancho y 88 píxeles de alto.
  • medium: Versión de mayor resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 320 píxeles de ancho y 180 píxeles de alto. Para un canal, esta imagen es de 240 píxeles de ancho y 240 píxeles de alto.
  • high: Versión de alta resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 480 píxeles de ancho y 360 píxeles de alto. Para un canal, esta imagen es de 800 píxeles de ancho y 800 píxeles de alto.
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:
  • hd
  • sd
contentDetails.caption string
Indica si hay subtítulos disponibles para el video.

Los valores válidos para esta propiedad son:
  • false
  • true
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:
  • mpaaG: G
  • mpaaNc17: NC-17
  • mpaaPg: PG
  • mpaaPg13: PG-13
  • mpaaR: R
  • mpaaUnrated
contentDetails.contentRating.tvpgRating string
Calificación de TV Parental Guidelines (TVPG) del video.

Los valores válidos para esta propiedad son:
  • tvpg14: TV-14
  • tvpgG: TV-G
  • tvpgMa: TV-MA
  • tvpgPg: TV-PG
  • tvpgUnrated
  • tvpgY: TV-Y
  • tvpgY7: TV-Y7
  • tvpgY7Fv: TV-Y7-FV
contentDetails.contentRating.bbfcRating string
Calificación de British Board of Film Classification (BBFC) del video.

Los valores válidos para esta propiedad son:
  • bbfc12: 12
  • bbfc12a: 12A
  • bbfc15: 15
  • bbfc18: 18
  • bbfcPg: PG
  • bbfcR18: R18
  • bbfcU: U
  • bbfcUnrated
contentDetails.contentRating.chvrsRating string
Calificación de Canadian Home Video Rating System (CHVRS) del video.

Los valores válidos para esta propiedad son:
  • chvrs14a: 14A
  • chvrs18a: 18A
  • chvrsE: E
  • chvrsG: G
  • chvrsPg: PG
  • chvrsR: R
  • chvrsUnrated
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:
  • eirinG: G
  • eirinPg12: PG-12
  • eirinR15plus: R15 +
  • eirinR18plus: R18 +
  • eirinUnrated
contentDetails.contentRating.cbfcRating string
Calificación de Central Board of Film Certification (CBFC - India) del video.

Los valores válidos para esta propiedad son:
  • cbfcA: A
  • cbfcS: S
  • cbfcU: U
  • cbfcUA: U/A
  • cbfcUnrated
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:
  • fmoc10: 10
  • fmoc12: 12
  • fmoc16: 16
  • fmoc18: 18
  • fmocE: E
  • fmocU: U
  • fmocUnrated
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:
  • icaa12: 12
  • icaa13: 13
  • icaa16: 16
  • icaa18: 18
  • icaa7: 7
  • icaaApta: APTA
  • icaaUnrated
  • icaaX: X
contentDetails.contentRating.acbRating string
Clasificación de Australian Classification Board (ACB) del video.

Los valores válidos para esta propiedad son:
  • acbE: E
  • acbG: G
  • acbM: M
  • acbMa15plus: MA15 +
  • acbPg: PG
  • acbR18plus: R18 +
  • acbUnrated
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:
  • oflcG: G
  • oflcM: M
  • oflcPg: PG
  • oflcR13: R13
  • oflcR15: R15
  • oflcR16: R16
  • oflcR18: R18
  • oflcUnrated
contentDetails.contentRating.fskRating string
Calificación de Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Alemania) del video.

Los valores válidos para esta propiedad son:
  • fsk0: FSK 0
  • fsk12: FSK 12
  • fsk16: FSK 16
  • fsk18: FSK 18
  • fsk6: FSK 6
  • fskUnrated
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:
  • kmrb12plus: 12 세 이상 관람가
  • kmrb15plus: 15 세 이상 관람가
  • kmrbAll: 전체 관람가
  • kmrbR: 청소년 관람 불가
  • kmrbTeenr
  • kmrbUnrated
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:
  • djctq10: 10
  • djctq12: 12
  • djctq14: 14
  • djctq16: 16
  • djctq18: 18
  • djctqL: L
  • djctqUnrated
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:
  • russia0: 0 +
  • russia12: 12 +
  • russia16: 16 +
  • russia18: 18 +
  • russia6: 6 +
  • russiaUnrated
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:
  • rtcA: A
  • rtcAa: AA
  • rtcB: B
  • rtcB15: B15
  • rtcC: C
  • rtcD: D
  • rtcUnrated
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:
  • ytAgeRestricted
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:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
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:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
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:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Estado de privacidad del video.

Los valores válidos para esta propiedad son:
  • private
  • public
  • unlisted
status.license string
Licencia del video.

Los valores válidos para esta propiedad son:
  • creativeCommon
  • youtube
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:
  • archive: El archivo es un archivo de almacenamiento, como un archivo .zip.
  • audio: El archivo es un tipo de archivo de audio conocido, como un archivo mp3.
  • document: El archivo es un documento o un archivo de texto, como un documento de MS Word.
  • image: El archivo es un archivo de imagen, como una imagen .jpeg.
  • other: El archivo es otro tipo de archivo que no es de video.
  • project: El archivo es un archivo de proyecto de video, como un proyecto de Microsoft Windows Movie Maker, que no contiene datos de video reales.
  • video: El archivo es un tipo de archivo de video conocido, como un archivo .mp4.
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:
  • clockwise: El video se debe girar 90 grados hacia la derecha.
  • counterClockwise: El video se debe girar 90 grados hacia la izquierda.
  • none: No es necesario girar el video.
  • other: El video se debe girar de alguna otra manera y de forma significativa.
  • upsideDown: El video se debe girar 180 grados.
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:
  • Solo fecha: YYYY-MM-DD
  • Hora local: YYYY-MM-DDTHH:MM:SS
  • Hora con zona horaria: YYYY-MM-DDTHH:MM:SS+HH:MM
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:
  • failed: El video no se pudo procesar. Consulta ProcessingFailureReason.
  • processing: El video se está procesando actualmente. Consulta ProcessingProgress.
  • succeeded: El video se procesó correctamente.
  • terminated: La información de procesamiento ya no está disponible.
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:
  • other: Se produjo un error en otro componente de procesamiento.
  • streamingFailed: El video no se pudo enviar a los transmisores continuos.
  • transcodeFailed: Se produjo un error en la transcodificación de contenido.
  • uploadFailed: Se produjo un error en la publicación de los archivos.
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:
  • archiveFile: Un archivo de almacenamiento (por ejemplo, un archivo ZIP).
  • audioFile: Archivo que contiene solo audio (por ejemplo, un archivo MP3).
  • docFile: Documento o archivo de texto (por ejemplo, documento de MS Word).
  • imageFile: Archivo de imagen (por ejemplo, una imagen JPEG).
  • notAVideoFile: Otros archivos que no son de video.
  • projectFile: Archivo de proyecto de película (por ejemplo, un proyecto de Microsoft Windows Movie Maker).
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:
  • hasEditlist: Las listas de edición no son compatibles actualmente.
  • inconsistentResolution: Resoluciones de contenedor y transmisión en directo en conflicto.
  • problematicAudioCodec: Se utilizó un códec de audio que podría causar problemas.
  • problematicVideoCodec: Se utilizó un códec de video que podría causar problemas.
  • unknownAudioCodec: Códec de audio no reconocido, es probable que se produzca un error en la transcodificación.
  • unknownContainer: Formato de archivo no reconocido, es probable que se produzca un error en la transcodificación.
  • unknownVideoCodec: Códec de video no reconocido, es probable que se produzca un error en la transcodificación.
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:
  • nonStreamableMov: El archivo MP4 no se puede transmitir en directo. Esto retrasará el proceso.
  • sendBestQualityVideo: Probablemente existe una versión de mejor calidad del video.
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:
  • audioQuietAudioSwap: La pista de audio aparece en silencio y se podría cambiar por una de mejor calidad.
  • videoAutoLevels: Los niveles de brillo de la imagen parecen inadecuados y se podrían corregir.
  • videoCrop: Se detectaron márgenes (mates) alrededor de la imagen que se podrían recortar.
  • videoStabilize: El video se mueve demasiado y se podría estabilizar.