Videos

Todos los videos que se suban a través del extremo videos.insert desde proyectos de API no verificados 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 ser sometido a una auditoría para 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:

getRating
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, configura sus metadatos.
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 quita una calificación de este. Pruébala ahora.
reportAbuse
Denunciar un video por incluir 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 manera inequívoca 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 este tiempo puede ser diferente al momento en que se subió el video. Por ejemplo, si un video se sube como privado y, posteriormente, se hace público, esta propiedad especificará el momento en que el video se hizo público.

Hay un par de casos especiales:
  • Si un video se sube como un video privado y el propietario del canal recupera los metadatos del video, el valor de la propiedad especifica la fecha y hora en que se subió el video.
  • Si un video se sube como no listado, el valor de la propiedad también especifica la fecha y hora en que se subió el video. En ese caso, cualquier persona que conozca el ID único del video podrá recuperar los metadatos.
El valor se especifica en el formato ISO 8601.
snippet.channelId string
Es el ID que YouTube utiliza para identificar de forma exclusiva el canal al que se subió el video.
snippet.title string
El 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 actualizas la parte snippet de un recurso video.
snippet.description string
La 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
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:
  • default: es la imagen en miniatura predeterminada. La viñeta predeterminada de un video, o de un recurso que se refiere a un video, como un elemento de una lista de reproducción o el resultado de una búsqueda, es de 120 píxeles 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: es una 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: Es una 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.
  • standard: es una versión de la imagen en miniatura con una resolución aún mayor que la de la imagen con resolución high. Esta imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de listas de reproducción o resultados de búsqueda. Esta imagen es de 640 píxeles de ancho y 480 píxeles de alto.
  • maxres: Es la versión con la resolución más alta de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de listas de reproducción o resultados de búsqueda. Esta imagen es de 1280 píxeles de ancho y 720 píxeles de alto.
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
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 acerca del cálculo del límite de caracteres:
  • El valor de propiedad es una lista y las comas entre sus elementos se contabilizan para el límite.
  • Si una etiqueta contiene un espacio, el servidor de la API maneja el valor de la etiqueta como si estuviera entre comillas, y estas se consideran en el límite de caracteres. Por lo tanto, a efectos del límite de caracteres, la etiqueta Foo-Baz contiene siete caracteres, pero la etiqueta Foo Baz contiene nueve caracteres.
snippet.categoryId string
Es la categoría del 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 futura o activa. También se muestra el valor "ninguno" si el video no es una transmisión en vivo activa o futura.

Los valores válidos para esta propiedad son los siguientes:
  • live
  • none
  • upcoming
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 bien el título en el idioma predeterminado de los metadatos del video.
  • El texto localizado se muestra en el fragmento de recurso si la solicitud videos.list usó el parámetro hl para especificar un idioma en el que se debe mostrar el texto localizado y el texto localizado está disponible en ese idioma.
  • Si no se especifica un valor del parámetro hl o se especifica un valor, pero los metadatos localizados no están disponibles para el idioma especificado, se muestran los metadatos del idioma predeterminado.
La propiedad contiene un valor de solo lectura. Usa el objeto localizations para agregar, actualizar o borrar títulos localizados.
snippet.localized.title string
Es el título localizado del video.
snippet.localized.description string
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, incluidas su duración y una indicación sobre si hay subtítulos disponibles.
contentDetails.duration string
La duración del video El valor de la propiedad es una duración en formato ISO 8601. Por ejemplo, para un video de al menos un minuto y menos de una hora, la duración se expresa en 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 dura al menos una hora, la duración tiene el formato PT#H#M#S, en el que la # que aparece antes de la letra H especifica la duración del video en horas y el resto de los detalles son los mismos que se describieron anteriormente. Si el video dura al menos un día, las letras P y T están separadas, y el formato del valor es P#DT#H#M#S. Consulta la especificación ISO 8601 para obtener más información.
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:
  • hd
  • sd
contentDetails.caption string
Indica si hay subtítulos disponibles para el video.

Los valores válidos para esta propiedad son los siguientes:
  • false
  • true
contentDetails.licensedContent boolean
Indica si el video representa contenido con licencia, es decir, 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 en los que es (o no es) visible un video. El objeto contendrá las propiedades contentDetails.regionRestriction.allowed o contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Una lista de los códigos regionales que identifican a 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 identifican 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 según 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:
  • acbC: programas que recibieron la clasificación C de la Autoridad Australiana de Comunicaciones y Medios. Estos programas están dirigidos a niños menores de 14 años que no estén en edad preescolar.
  • De acbE a E
  • De acbG a G
  • De acbM a M
  • acbMa15plus-MA15+
  • acbP: programas que recibieron la clasificación P de la Autoridad Australiana de Comunicaciones y Medios. Estos programas están dirigidos a niños de preescolar.
  • acbPg: PG
  • acbR18plus: ZAR 18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
La calificación del video de la Autorità per le Garanzie nelle Comunicazioni (AGCOM) de Italia.

Los valores válidos para esta propiedad son los siguientes:
  • agcomT-T
  • agcomUnrated
  • agcomVm14: VM14
  • agcomVm18: VM18
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:
  • De anatelA a A
  • anatelF-F
  • anatelI - I
  • anatelI10: I-10
  • anatelI12: I-12
  • anatelI7: I-7
  • De anatelR a R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Calificación del Consejo Británico de Clasificación de Películas (BBFC) del video.

Los valores válidos para esta propiedad son los siguientes:
  • De bbfc12 a 12
  • De bbfc12a a 12 a.m.
  • De bbfc15 a 15
  • De bbfc18 a 18
  • bbfcPg: PG
  • bbfcR18: ZAR 18
  • De bbfcU a U
  • bbfcUnrated
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:
  • De bfvc13 a 13
  • De bfvc15 a 15
  • De bfvc18 a 18
  • De bfvc20 a 20
  • De bfvcB a B
  • De bfvcE a E
  • De bfvcG a G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
La calificación del video según la Junta de Clasificación de Medios de Austria (Bundesministerium für Unterricht, Kunst und Kultur).

Los valores válidos para esta propiedad son los siguientes:
  • bmukk10: 10 o más
  • bmukk12: 12 años o más
  • bmukk14: 14 años o más
  • bmukk16: 16 años o más
  • bmukk6: 6 años o más
  • bmukk8: 8 años o más
  • bmukkAa: sin restricciones
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Sistema de clasificación de la TV canadiense: Sistema de clasificación de TV canadiense La clasificación del video de la Comisión Canadiense de Radiotelevisión y Telecomunicaciones (CRTC) para las 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:
  • catv14plus: 14 años o más
  • catv18plus: mayores de 18 años
  • De catvC a C
  • catvC8-C8
  • De catvG a G
  • catvPg: PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
La clasificació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:
  • catvfr13plus: 13 años o más
  • catvfr16plus: 16 años o más
  • catvfr18plus: mayores de 18 años
  • catvfr8plus: 8 años o más
  • De catvfrG a G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
La calificación de la Junta Central de Certificación Fílmica (CBFC - India) del video.

Los valores válidos para esta propiedad son los siguientes:
  • De cbfcA a A
  • cbfcS-S
  • De cbfcU a U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Consejo de Calificación Cinematográfica (Chile) del video.

Los valores válidos para esta propiedad son los siguientes:
  • ccc14: 14 años o más
  • ccc18: mayores de 18 años
  • ccc18s – Mayores de 18 años: contenido pornográfico
  • ccc18v – Más de 18 años: contenido excesivamente violento
  • ccc6 – 6 años o más: Inconveniente para menores de 7 años
  • cccTe: Todo entre usuarios
  • cccUnrated
contentDetails.contentRating.cceRating string
La calificación del video de la Comissão de Classificação de Espect 'culos de Portugal.

Los valores válidos para esta propiedad son los siguientes:
  • De cceM12 a 12
  • De cceM14 a 14
  • De cceM16 a 16
  • De cceM18 a 18
  • De cceM4 a 4
  • De cceM6 a 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
La calificación del video en Suiza.

Los valores válidos para esta propiedad son los siguientes:
  • De chfilm0 a 0
  • De chfilm12 a 12
  • De chfilm16 a 16
  • De chfilm18 a 18
  • De chfilm6 a 6
  • chfilmUnrated
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:
  • De chvrs14a a 14 a
  • De chvrs18a a 18 a.m.
  • De chvrsE a E
  • De chvrsG a G
  • chvrsPg: PG
  • De chvrsR a R
  • chvrsUnrated
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:
  • De cicfE a E
  • cicfKntEna-KNT/ENA
  • cicfKtEa: KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
La calificación del video de la CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) de Rumania.

Los valores válidos para esta propiedad son los siguientes:
  • De cna12 a 12
  • De cna15 a 15
  • De cna18 a 18
  • cna18plus: mayores de 18 años
  • cnaAp, AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Sistema de clasificación en Francia: Comisión de clasificación cinematográfica

Los valores válidos para esta propiedad son los siguientes:
  • De cnc10 a 10
  • De cnc12 a 12
  • De cnc16 a 16
  • De cnc18 a 18
  • De cncE a E
  • cncT-T
  • cncUnrated
contentDetails.contentRating.csaRating string
La calificación del video de la 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:
  • De csa10 a 10
  • De csa12 a 12
  • De csa16 a 16
  • De csa18 a 18
  • csaInterdiction: Interdicción
  • csaT-T
  • csaUnrated
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:
  • De cscf12 a 12
  • De cscf16 a 16
  • De cscf18 a 18
  • De cscf6 a 6
  • De cscf9 a 9
  • De cscfA a A
  • cscfAl, AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
La calificación del video en República Checa.

Los valores válidos para esta propiedad son los siguientes:
  • De czfilm12 a 12
  • De czfilm14 a 14
  • De czfilm18 a 18
  • De czfilmU a U
  • czfilmUnrated
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 los siguientes:
  • De djctq10 a 10
  • De djctq12 a 12
  • De djctq14 a 14
  • De djctq16 a 16
  • De djctq18 a 18
  • De djctqL a M
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Motivos que explican por qué el video recibió la clasificación DJCQT (Brasil).
contentDetails.contentRating.ecbmctRating string
Sistema de clasificación en Türkiye: Junta de Evaluación y Clasificación del Ministerio de Cultura y Turismo

Los valores válidos para esta propiedad son los siguientes:
  • De ecbmct13a a 13 a.m.
  • ecbmct13plus: 13 años o más
  • ecbmct15a-15 A
  • ecbmct15plus: 15 años o más
  • ecbmct18plus: mayores de 18 años
  • De ecbmct7a a 7 a
  • ecbmct7plus: 7 años o más
  • De ecbmctG a G
  • ecbmctUnrated
  • De ecbmct6a a 6 a.m.
  • ecbmct6plus: 6 años o más
  • ecbmct10a-10 A
  • ecbmct10plus: 10 o más
  • ecbmct16plus: 16 años o más
contentDetails.contentRating.eefilmRating string
La calificación del video en Estonia.

Los valores válidos para esta propiedad son los siguientes:
  • eefilmK12: preescolar a bachillerato
  • eefilmK14: preescolar a bachillerato
  • eefilmK16: preescolar a bachillerato
  • eefilmK6: preescolar a 6o grado
  • De eefilmL a M
  • eefilmMs12, MS-12
  • eefilmMs6, MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
La calificación del video en Egipto.

Los valores válidos para esta propiedad son los siguientes:
  • De egfilm18 a 18
  • egfilmBn-BN
  • egfilmGn, GN
  • egfilmUnrated
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:
  • De eirinG a G
  • eirinPg12: PG-12
  • eirinR15plus: ZAR 15 o más
  • eirinR18plus: ZAR 18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
La calificación del video de la Junta de Censura de Cine de Malasia.

Los valores válidos para esta propiedad son los siguientes:
  • De fcbm13 a 13
  • De fcbm16 a 16
  • De fcbm18 a 18
  • De fcbm18pa a 18 PA
  • fcbm18pl–PLN 18
  • fcbm18sg a SGD 18
  • De fcbm18sx a 18 SX
  • fcbmP12: P12
  • fcbmP13: P13
  • fcbmPg13: PG13
  • De fcbmU a U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
La calificación del video según la Oficina de Administración de Películas, Periódicos y Artículos de Hong Kong.

Los valores válidos para esta propiedad son los siguientes:
  • fcoI - I
  • fcoIi - II
  • fcoIia: IIA
  • fcoIib - IIB
  • De fcoIii a III
  • fcoUnrated
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 calificació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:
  • De fmoc10 a 10
  • De fmoc12 a 12
  • De fmoc16 a 16
  • De fmoc18 a 18
  • De fmocE a E
  • De fmocU a U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
La calificación del video de la Junta de Cine y Publicación de Sudáfrica.

Los valores válidos para esta propiedad son los siguientes:
  • De fpb10 a 10
  • fpb1012Pg: De 10 a 12PG
  • De fpb13 a 13
  • De fpb16 a 16
  • De fpb18 a 18
  • fpb79Pg: De 7 a 9PG
  • De fpbA a A
  • fpbPg: PG
  • fpbUnrated
  • fpbX18 - X18
  • De fpbXx a XX
contentDetails.contentRating.fpbRatingReasons[] list
Motivos que explican por qué el video recibió la clasificación FPB (Sudáfrica).
contentDetails.contentRating.fskRating string
Calificación Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Alemania) del video.

Los valores válidos para esta propiedad son los siguientes:
  • fsk0: FSK 0
  • fsk12: FSK 12
  • fsk16: FSK 16
  • fsk18: FSK 18
  • fsk6: FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
La calificación del video en Grecia.

Los valores válidos para esta propiedad son los siguientes:
  • De grfilmE a E
  • grfilmK-K
  • grfilmK12: preescolar a bachillerato
  • grfilmK13: preescolar a bachillerato
  • grfilmK15-preescolar a bachillerato
  • grfilmK17: preescolar a bachillerato
  • grfilmK18: preescolar a bachillerato
  • grfilmUnrated
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 los siguientes:
  • De icaa12 a 12
  • De icaa13 a 13
  • De icaa16 a 16
  • De icaa18 a 18
  • De icaa7 a 7
  • icaaApta, APTA
  • icaaUnrated
  • icaaX-X
contentDetails.contentRating.ifcoRating string
Calificación de la Oficina de Clasificación de Películas de Irlanda (IFCO - Irlanda) del video. Consulta el sitio web de IFCO para obtener más información.

Los valores válidos para esta propiedad son los siguientes:
  • De ifco12 a 12
  • De ifco12a a 12 a.m.
  • De ifco15 a 15
  • ifco15a-15 A
  • De ifco16 a 16
  • De ifco18 a 18
  • De ifcoG a G
  • ifcoPg: PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
La calificación del video en Israel.

Los valores válidos para esta propiedad son los siguientes:
  • De ilfilm12 a 12
  • De ilfilm16 a 16
  • De ilfilm18 a 18
  • ilfilmAa - AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
La calificación INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) del video.

Los valores válidos para esta propiedad son los siguientes:
  • incaaAtp: ATP (Apta para todo publico)
  • incaaC – X (Solo apto para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apto para mayores de 13 años)
  • incaaSam16 – 16 (Solo apto para mayores de 16 años)
  • incaaSam18 – 18 (Solo apto para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
La calificación del video según la Junta de Clasificación de Películas de Kenia.

Los valores válidos para esta propiedad son los siguientes:
  • De kfcb16plus a 16
  • kfcbG, GE
  • kfcbPg: PG
  • De kfcbR a 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Países Bajos).

Los valores válidos para esta propiedad son los siguientes:
  • De kijkwijzer12 a 12
  • De kijkwijzer14 a 14
  • De kijkwijzer16 a 16
  • De kijkwijzer18 a 18
  • De kijkwijzer6 a 6
  • De kijkwijzer9 a 9
  • kijkwijzerAl, AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Calificación de Korea Media Rating Board (영高물등킱號號值) del video. El KMRB califica los videos en Corea del Sur.

Los valores válidos para esta propiedad son los siguientes:
  • kmrb12plus: 12 ಠ 이ಠ 터사
  • kmrb15plus: 15 이 이터 이話 conlleva
  • kmrbAll: ಠ체체터
  • kmrbR: 청년 미불 seis
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
La calificación del video de la película indonesia Lembaga Sensor.

Los valores válidos para esta propiedad son los siguientes:
  • De lsf13 a 13
  • De lsf17 a 17 años
  • De lsf21 a 21
  • De lsfA a A
  • lsfBo-BO
  • lsfD-D
  • De lsfR a R
  • lsfSu-SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
La calificación del video de la Film Age-Classification Board de Malta.

Los valores válidos para esta propiedad son los siguientes:
  • De mccaa12 a 12
  • De mccaa12a a 12 a.m.
  • mccaa14: 14: Esta calificación se quitó de la nueva estructura de clasificación que se introdujo en 2013.
  • De mccaa15 a 15
  • mccaa16: 16: Esta calificación se quitó de la nueva estructura de clasificación que se introdujo en 2013.
  • De mccaa18 a 18
  • mccaaPg: PG
  • De mccaaU a U
  • mccaaUnrated
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:
  • De mccyp11 a 11
  • De mccyp15 a 15
  • De mccyp7 a 7
  • De mccypA a A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
El sistema de clasificación del video para Vietnam: MCST

Los valores válidos para esta propiedad son los siguientes:
  • De mcst0 a 0
  • mcst16plus: 16 años o más
  • mcstC13: C13
  • mcstC16-C16
  • mcstC18: C18
  • De mcstP a P
  • mcstUnrated
  • mcstT13: T13
  • mcstT16: T16
  • mcstT18: T18
  • mcstK-K
contentDetails.contentRating.mdaRating string
La calificación del video según la Autoridad de Desarrollo de Medios (MDA) de Singapur y, en particular, la Junta de Censores de Cine (BFC).

Los valores válidos para esta propiedad son los siguientes:
  • De mdaG a G
  • mdaM18-M18
  • mdaNc16-NC16
  • mdaPg: PG
  • mdaPg13: PG13
  • mdaR21: ZAR 21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
La calificación del video por parte de Medietilsynet, la Autoridad de Medios de Noruega.

Los valores válidos para esta propiedad son los siguientes:
  • De medietilsynet11 a 11
  • De medietilsynet12 a 12
  • De medietilsynet15 a 15
  • De medietilsynet18 a 18
  • De medietilsynet6 a 6
  • De medietilsynet7 a 7
  • De medietilsynet9 a 9
  • De medietilsynetA a A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
La calificación del video del Kansallinen Audiovisuaalinen Instituutti (Instituto Audiovisual Nacional) de Finlandia

Los valores válidos para esta propiedad son los siguientes:
  • De meku12 a 12
  • De meku16 a 16
  • De meku18 a 18
  • De meku7 a 7
  • mekuS-S
  • mekuUnrated
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:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
La calificación del Ministerio de Cultura (Colombia) del video.

Los valores válidos para esta propiedad son los siguientes:
  • De moc12 a 12
  • De moc15 a 15
  • De moc18 a 18
  • De moc7 a 7
  • mocBanned: bloqueado
  • De mocE a E
  • mocT-T
  • mocUnrated
  • mocX-X
contentDetails.contentRating.moctwRating string
La calificación del video proporcionada por el Ministerio de Cultura de Taiwán (próximos 化部).

Los valores válidos para esta propiedad son los siguientes:
  • De moctwG a G
  • De moctwP a P
  • moctwPg: PG
  • De moctwR a R
  • moctwR12: R-12
  • moctwR15: ZAR-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
La calificación del video de la Motion Picture Association of America (MPAA).

Los valores válidos para esta propiedad son los siguientes:
  • De mpaaG a G
  • mpaaNc17, NC-17
  • mpaaPg: PG
  • mpaaPg13: PG-13
  • De mpaaR a R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Calificación de la Motion Picture Association of America sobre avances y vistas previas de películas.

Los valores válidos para esta propiedad son los siguientes:
  • mpaatGb – GB (Banda verde: aprobado para todos los públicos)
  • mpaatRb – RB (banda roja: recomendado para mayores de 17 años)
contentDetails.contentRating.mtrcbRating string
La calificación del video según la Junta de Revisión y Clasificación de Películas (Filipinas).

Los valores válidos para esta propiedad son los siguientes:
  • De mtrcbG a G
  • mtrcbPg: PG
  • mtrcbR13: R-13
  • mtrcbR16: R-16
  • mtrcbR18: ZAR-18
  • mtrcbUnrated
  • mtrcbX-X
contentDetails.contentRating.nbcRating string
La calificación del video de la Oficina Nacional de Clasificación de las Maldivas.

Los valores válidos para esta propiedad son los siguientes:
  • nbc12plus: 12 años o más
  • nbc15plus: 15 años o más
  • nbc18plus: mayores de 18 años
  • nbc18plusr: Más de 18 años
  • De nbcG a G
  • nbcPg: PG
  • nbcPu – PU
  • nbcUnrated
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:
  • De nfrcA a A
  • De nfrcB a B
  • De nfrcC a C
  • nfrcD-D
  • nfrcUnrated
  • nfrcX-X
contentDetails.contentRating.nfvcbRating string
La calificación del video según el Consejo Nacional de Censores de Películas y Video de Nigeria.

Los valores válidos para esta propiedad son los siguientes:
  • De nfvcb12 a 12
  • De nfvcb12a a 12 a.m.
  • De nfvcb15 a 15
  • De nfvcb18 a 18
  • De nfvcbG a G
  • nfvcbPg: PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
La calificación del video según los centros de Nacionãlais Kino (Centro Nacional de Cine de Letonia)

Los valores válidos para esta propiedad son los siguientes:
  • nkclv12plus: 12 años o más
  • nkclv18plus: mayores de 18 años
  • nkclv7plus: 7 años o más
  • De nkclvU a U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Calificación de Office of Film and Literature Classification (OFLC - New Zealand)

Los valores válidos para esta propiedad son los siguientes:
  • De oflcG a G
  • De oflcM a M
  • oflcPg: PG
  • oflcR13: ZAR 13
  • oflcR15: ZAR 15
  • oflcR16: ZAR 16
  • oflcR18: ZAR 18
  • oflcRp13: RP13
  • oflcRp16: RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
La calificación del video en Perú.

Los valores válidos para esta propiedad son los siguientes:
  • De pefilm14 a 14
  • De pefilm18 a 18
  • pefilmPg: PG
  • pefilmPt-PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
La calificación del video en Venezuela.

Los valores válidos para esta propiedad son los siguientes:
  • De resorteviolenciaA a A
  • De resorteviolenciaB a B
  • De resorteviolenciaC a C
  • resorteviolenciaD-D
  • De resorteviolenciaE a E
  • resorteviolenciaUnrated
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:
  • De rtcA a A
  • rtcAa - AA
  • De rtcB a B
  • rtcB15: B15
  • De rtcC a C
  • rtcD-D
  • rtcUnrated
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:
  • rteCh-CH
  • rteGa – DG
  • rteMa-MA
  • rtePs (PS)
  • rteUnrated
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:
  • russia0: 0 o más
  • russia12: 12 años o más
  • russia16: 16 años o más
  • russia18: mayores de 18 años
  • russia6: 6 años o más
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
La calificación del video en Eslovaquia.

Los valores válidos para esta propiedad son los siguientes:
  • De skfilmG a G
  • skfilmP2 - P2
  • skfilmP5-P5
  • skfilmP8-P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
La calificación del video en Islandia.

Los valores válidos para esta propiedad son los siguientes:
  • De smais12 a 12
  • De smais14 a 14
  • De smais16 a 16
  • De smais18 a 18
  • De smais7 a 7
  • De smaisL a M
  • smaisUnrated
contentDetails.contentRating.smsaRating string
La calificación del video de Statens medieråd (Consejo Nacional de Medios de Suecia).

Los valores válidos para esta propiedad son los siguientes:
  • De smsa11 a 11
  • De smsa15 a 15
  • De smsa7 a 7
  • smsaA: todas las edades
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Clasificación de TV Parental Guidelines (TVPG) del video.

Los valores válidos para esta propiedad son los siguientes:
  • tvpgG (TV-G)
  • tvpgMa (TV-MA)
  • tvpgPg: TV-PG
  • tvpgUnrated
  • tvpgY: TV-Y
  • tvpgY7: TV-Y7
  • tvpgY7Fv: TV-Y7-FV
  • pg14: TV-14
contentDetails.contentRating.ytRating string
Una clasificación que YouTube utiliza para identificar el contenido con restricción de edad.

Los valores válidos para esta propiedad son los siguientes:
  • ytAgeRestricted
contentDetails.projection string
Especifica el formato de proyección del video.

Los valores válidos para esta propiedad son los siguientes:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Indica si quien subió el video proporcionó una imagen miniatura personalizada para este. Solo quien sube el video podrá ver esta propiedad.
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:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
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:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Este valor explica por qué YouTube rechazó un video subido. 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:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
El estado de privacidad del video.

Los valores válidos para esta propiedad son los siguientes:
  • private
  • public
  • unlisted
status.publishAt datetime
Corresponde a la fecha y hora en que está programado el video para publicarse. Solo se puede configurar si el estado de privacidad del video es privado. El valor se especifica en el formato ISO 8601. Ten en cuenta estos dos puntos adicionales acerca del comportamiento de esta propiedad:
  • Si configuras el valor de esta propiedad cuando llamas al método videos.update, también debes establecer el valor de la propiedad status.privacyStatus en private, incluso si el video ya es privado.
  • Si tu solicitud programa la publicación de un video en algún momento en el pasado, este se publicará de inmediato. Por lo tanto, el efecto de establecer la propiedad status.publishAt en una fecha y hora pasadas es el mismo que cambiar la privacyStatus del video de private a public.
status.license string
La licencia del video.

Los valores válidos para esta propiedad son los siguientes:
  • creativeCommon
  • youtube
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 del video extendido en la página de reproducción del video son visibles públicamente. De forma predeterminada, esas estadísticas se pueden ver, y estadísticas como la cantidad de reproducciones y las calificaciones de un video seguirán siendo visibles públicamente, incluso si el valor de esta propiedad se establece en false.
status.madeForKids boolean
Este valor indica si el video está clasificado como contenido dirigido a niños y contiene el estado actual “creado para niños” Por ejemplo, el estado se podría determinar en función del 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 que el video está 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 se convirtió en 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.

La 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 está siempre establecido en 0.
statistics.commentCount unsigned long
La cantidad de comentarios del 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.
  • Si la solicitud de la API para recuperar el recurso especifica un valor para los parámetros maxHeight o maxWidth, el tamaño del reproductor incorporado se ajusta para cumplir con los requisitos de maxHeight o maxWidth.
  • Si no se conoce la relación de aspecto del video, el formato predeterminado del reproductor incorporado es 4:3.
player.embedHeight long
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
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 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 temas relevantes para el video.

Esta propiedad dejó de estar disponible el 10 de noviembre de 2016. Se admitirá hasta el 10 de noviembre de 2017.

Importante: Debido a que Freebase y la API de Freebase dejaron de estar disponibles, los IDs de los temas 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 IDs de temas seleccionados.

topicDetails.topicCategories[] list
Una lista de URLs de Wikipedia que brindan 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 en la que 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 las propiedades secundarias identifican la ubicación que el propietario del video desea asociar con él. El valor se puede editar, se puede buscar en los videos públicos y se puede mostrar a los usuarios en esos videos.
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.

Es la 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.

Es la 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 el 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, 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 subido. Este campo está presente si se subió un archivo de video u otro tipo de archivo.
fileDetails.fileType string
El tipo de archivo subido según lo que detecta el motor de procesamiento de videos de YouTube. Actualmente, YouTube solo procesa archivos de video. Sin embargo, este campo está presente si se subió un archivo de video o algún otro tipo de archivo.

Los valores válidos para esta propiedad son los siguientes:
  • archive: el archivo es un archivo de almacenamiento, como un archivo .zip.
  • audio: se trata de un tipo de archivo de audio conocido, como un archivo .mp3.
  • document: el archivo es un documento o 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: se trata de 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
Es una 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. Puedes calcular la relación de aspecto de la 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
La 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 de la fuente original a fin de mostrar correctamente el video.

Los valores válidos para esta propiedad son los siguientes:
  • clockwise: el video se debe girar 90 grados en el sentido de las manecillas del reloj.
  • counterClockwise: el video se debe girar 90 grados en sentido contrario a las manecillas del reloj.
  • none: no es necesario girar el video.
  • other: el video se debe rotar de alguna otra manera y de forma significativa.
  • upsideDown: el video se debe girar 180 grados.
fileDetails.videoStreams[].vendor string
Es un valor que identifica de manera inequívoca 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
Cantidad de canales de audio que contiene la transmisión.
fileDetails.audioStreams[].codec string
Códec de audio que usa la transmisión continua.
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 manera inequívoca 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ó en milisegundos.
fileDetails.bitrateBps unsigned long
La tasa de bits combinada (video y audio) del archivo de video subido en bits por segundo.
fileDetails.creationTime string
Fecha y hora en la 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 de uso: YYYY-MM-DDTHH:MM:SS
  • Hora con zona horaria: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
El objeto processingDetails 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 sondear, de modo que el video subido pueda hacer un seguimiento del progreso que YouTube ha hecho en el procesamiento del archivo de video que se subió. 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:
  • failed: se produjo un error durante el procesamiento del video. ConsultaVer 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 video. Los valores son relevantes solo 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
La cantidad de partes del video que YouTube ya procesó. Para calcular el porcentaje del video que YouTube ya procesó, puedes usar la siguiente fórmula:
100 * parts_processed / parts_total

Ten en cuenta que, debido a que la cantidad estimada de partes podría aumentar sin un aumento correspondiente en la cantidad de partes que ya se procesaron, es posible que el progreso calculado disminuya periódicamente mientras YouTube procesa un video.
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:
  • other: se produjo un error en otro componente de procesamiento.
  • streamingFailed: no se pudo enviar el video a los transmisores continuos.
  • transcodeFailed: Se produjo un error en la transcodificación de contenido.
  • uploadFailed: se produjo un error al enviar los archivos.
processingDetails.fileDetailsAvailability string
Este valor indica si los detalles del archivo 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 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 las imágenes en miniatura se generaron para el video.
suggestions object
El objeto suggestions contiene sugerencias que identifican oportunidades para mejorar la calidad de video o los metadatos del video subido. 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, con el tiempo, ese estado será failed.

Los valores válidos para esta propiedad son los siguientes:
  • archiveFile: Es un archivo de almacenamiento (por ejemplo, un archivo ZIP).
  • audioFile: el archivo solo contiene audio (por ejemplo, un archivo MP3).
  • docFile: documento o archivo de texto (p.ej., documento de MS Word).
  • imageFile: archivo de imagen (p.ej., una imagen JPEG).
  • notAVideoFile: otros archivos que no son de video
  • projectFile: archivo de proyecto de película (p.ej., proyecto de Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Esta es una lista de los motivos por los que YouTube puede tener dificultades para transcodificar el video subido o que puedan 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 podrían causar inconvenientes, como problemas de sincronización, artefactos de video o falta una pista de audio.

Los valores válidos para esta propiedad son los siguientes:
  • hasEditlist: por el momento, no se admiten las listas de edición.
  • inconsistentResolution: resoluciones de contenedor y transmisión en conflicto.
  • problematicAudioCodec: se utilizó el 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: no se reconoce el formato de archivo, es probable que se produzca un error en la transcodificación.
  • unknownVideoCodec: no se reconoce el códec de video. Es probable que se produzca un error en la transcodificación.
suggestions.processingHints[] list
Una lista de sugerencias que pueden mejorar la capacidad de YouTube para procesar el video.

Los valores válidos para esta propiedad son los siguientes:
  • nonStreamableMov: el archivo MP4 no se puede transmitir, lo que ralentizará el procesamiento.
  • sendBestQualityVideo: probablemente existe una versión de mejor calidad del video.
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
La etiqueta de palabra clave sugerida para el video.
suggestions.tagSuggestions[].categoryRestricts[] list
Un conjunto de categorías de video para las 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 o la experiencia de reproducción del video que se subió.

Los valores válidos para esta propiedad son los siguientes:
  • audioQuietAudioSwap: la pista de audio parece silenciosa 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 ve tembloroso y se podría estabilizar.
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 transmisión en vivo futura, en vivo o finalizada.
liveStreamingDetails.actualStartTime datetime
Es la hora a la que comenzó 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 reproducciones del video. Ten en cuenta que YouTube deja de hacer un seguimiento de 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
El ID del chat en vivo actualmente activo adjunto a este video. Este campo se rellena solo si el video es una transmisión en vivo actualmente que incluye chat en vivo. Cuando se complete la transición de la transmisión para completar este campo, se quitará el chat en vivo y se cerrará. En las transmisiones continuas, el ID del chat en vivo ya no estará vinculado a este video, sino que al video nuevo que se muestre en la página persistente.
localizations object
El objeto localizations contiene traducciones de los metadatos del video.
localizations.(key) object
El 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
La descripción localizada del video