Videos

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 especificados. Pruébala ahora.
list
Devuelve una lista de videos que coinciden con los parámetros de la solicitud a la API. Pruébala ahora.
batchGetStats
Recupera una lista de estadísticas de video que coinciden con los parámetros de la solicitud a la API. Pruébala ahora.
insertar
Sube un video a YouTube y, de manera opcional, establece los metadatos del video.
update
Actualiza los metadatos de un video. Pruébala ahora.
borrar
Borra un video de YouTube. Pruébala ahora.
rate
Agrega una calificación de Me gusta o No me gusta a un video, o quita una calificación de un video. 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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": 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
Es el ID que YouTube usa para identificar el video de forma inequívoca.
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. Esta hora puede ser diferente de la hora en que se subió el video. Por ejemplo, si un video se sube como privado y, luego, se hace público, esta propiedad especificará la hora en que se hizo público.

Hay algunos casos especiales:
  • Si un video se sube como 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 la hora en que se subió el video. En este caso, cualquier persona que conozca el ID de video único del video puede recuperar sus metadatos.
  • Si un video se sube como video exclusivo para miembros, el valor de la propiedad especifica la fecha y hora en que se subió.
El valor se especifica en formato ISO 8601.
snippet.channelId string
Es el ID que usa YouTube para identificar de forma inequívoca el canal al que se subió el video. Este valor puede cambiar con el tiempo, por ejemplo, cuando se reasigna un video a un canal diferente (por ejemplo, un canal de temas o un canal de artista).
snippet.title string
Es 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
Es 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 >.

Puedes crear capítulos de video si incluyes marcas de tiempo con formato (por ejemplo, 00:00) en el texto de la descripción.
snippet.thumbnails object
Es un mapa de imágenes en miniatura asociadas con el video. Para cada objeto en el mapa, la clave es el nombre de la imagen en miniatura, y el valor es un objeto que contiene otra información 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 miniatura predeterminada de un video (o de un recurso que hace referencia a un video, como un elemento de playlist o un resultado de la búsqueda) tiene 120 px de ancho y 90 px 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 en 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 más alta 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 los elementos de playlists o los resultados de la búsqueda. Esta imagen tiene 640 px de ancho y 480 px de alto.
  • maxres: Es una versión en alta resolución 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 playlists o resultados de la búsqueda. Esta imagen tiene 1,280 px de ancho y 720 px de alto.
  • fhd: Es la versión en alta definición completa (1080p) de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos. Esta imagen tiene 1920 px de ancho y 1080 px de alto.
  • qhd: Es la versión de alta definición cuádruple (1440p / 2K) de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos. Esta imagen tiene 2,560 px de ancho y 1,440 px de alto.
  • uhd: Es la versión de resolución ultraalta (4K) de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos. Esta imagen tiene 3,840 px de ancho y 2,160 px de alto.
snippet.thumbnails.(key).url string
Es la URL de la imagen.
snippet.thumbnails.(key).width unsigned integer
Es el ancho de la imagen.
snippet.thumbnails.(key).height unsigned integer
Altura de la imagen.
snippet.channelTitle string
Es el título del canal al que pertenece el video.
snippet.tags[] list
Es una lista de etiquetas de palabras clave asociadas con el video. Las etiquetas pueden contener espacios. La longitud máxima del valor de la propiedad es de 500 caracteres. Ten en cuenta las siguientes reglas sobre cómo se calcula el límite de caracteres:
  • El valor de la propiedad es una lista, y las comas entre los elementos de la lista se tienen en cuenta para el límite.
  • Si una etiqueta contiene un espacio, el servidor de la API controla el valor de la etiqueta como si estuviera entre comillas, y las comillas se tienen en cuenta para el límite de caracteres. Por lo tanto, para los fines de los límites de caracteres, la etiqueta Foo-Baz contiene siete caracteres, pero la etiqueta Foo Baz contiene nueve.
snippet.categoryId string
Es la categoría de video de YouTube asociada al 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 próxima o activa. Su valor es none si el video no es una transmisión en vivo próxima o activa.



Los valores válidos para esta propiedad son los siguientes:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Es 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 para el video, o bien el título en el idioma predeterminado para los metadatos del video.
  • El texto localizado se devuelve en el fragmento del recurso si la solicitud videos.list usó el parámetro hl para especificar un idioma en el que se debe devolver el texto localizado y el texto localizado está disponible en ese idioma.
  • Los metadatos del idioma predeterminado se muestran si no se especifica un valor del parámetro hl o si se especifica un valor, pero no hay metadatos localizados disponibles para el idioma especificado.
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
Es la descripción localizada del video.
snippet.defaultAudioLanguage string
La propiedad default_audio_language especifica el idioma que se habla en la pista de audio predeterminada del video.
contentDetails object
El objeto contentDetails contiene información sobre el contenido de video, incluida su duración y una indicación de si hay subtítulos disponibles para el video.
contentDetails.duration string
Es la duración del video. El valor de la propiedad es una duración en formato ISO 8601. Por ejemplo, para un video que dura al menos un minuto y menos de una hora, la duración tiene el formato PT#M#S, en el que las letras PT indican que el valor especifica un período, y las letras M y S 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 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 se expresa en el formato PT#H#M#S, en el que el # que precede a la letra H especifica la duración del video en horas y todos los demás detalles son los mismos que se describieron anteriormente. Si el video dura al menos un día, las letras P y T se separan, y el formato del valor es P#DT#H#M#S. Consulta la especificación ISO 8601 para obtener todos los detalles.
contentDetails.dimension string
Indica si el video está disponible en 3D o en 2D.
contentDetails.definition string
Indica si el video está disponible en alta definición (HD) o solo en definición estándar.

Los valores válidos para esta propiedad son los siguientes:
  • 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, lo que significa que el contenido se subió a un canal vinculado a un socio de contenido de YouTube y, luego, ese socio lo reclamó.
contentDetails.regionRestriction object
El objeto regionRestriction contiene información sobre los países en los que se puede (o no) ver un video. El objeto contendrá la propiedad contentDetails.regionRestriction.allowed o la propiedad contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Es una lista de códigos de región que identifican los países en los que 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
Es una lista de códigos de región que identifican los países en los que 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 calificaciones que recibió el video en los distintos esquemas de calificación.
contentDetails.contentRating.acbRating string
Clasificación del 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 ya no estén en edad preescolar.
  • acbE – E
  • acbG – G
  • acbM – 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 en edad preescolar.
  • acbPg: PG
  • acbR18plus: Mayores de 18 años
  • acbUnrated
contentDetails.contentRating.agcomRating string
La clasificación del video según 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 clasificación de Anatel (Asociación Nacional de Televisión) del video para la televisión chilena.

Los valores válidos para esta propiedad son los siguientes:
  • anatelA – A
  • anatelF: F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12, I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Es la clasificación de la British Board of Film Classification (BBFC) del video.

Los valores válidos para esta propiedad son los siguientes:
  • bbfc12 – 12
  • bbfc12a, 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg: PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
La clasificación del video según la Junta de Censores de Cine y Video de Tailandia.

Los valores válidos para esta propiedad son los siguientes:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
La clasificació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+
  • bmukk12: Mayores de 12 años
  • bmukk14 – 14+
  • bmukk16: Mayores de 16 años
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa: Sin restricciones
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Sistema de clasificación de TV canadiense: Sistema de clasificación de TV canadiense La clasificación del video de la Comisión de Radio, Televisión y Telecomunicaciones de Canadá (CRTC) para las transmisiones en inglés canadiense. 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: Mayores de 14 años
  • catv18plus: Mayores de 18 años
  • catvC: C
  • catvC8: C8
  • catvG – G
  • catvPg, PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Es la clasificación del video de la Comisión Canadiense de Radio, Televisión y Telecomunicaciones (CRTC) para las transmisiones en francés canadiense. 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: Mayores de 13 años
  • catvfr16plus: Mayores de 16 años
  • catvfr18plus: Mayores de 18 años
  • catvfr8plus: Mayores de 8 años
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Es la clasificación del Consejo Central de Certificación Cinematográfica (CBFC) de la India para el video.

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

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

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

Los valores válidos para esta propiedad son los siguientes:
  • chfilm0: 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
La clasificación del video según el Sistema Canadiense de Clasificación de Videos (CHVRS).

Los valores válidos para esta propiedad son los siguientes:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg, PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
La clasificación del video según la Commission de Contrôle des Films (Bélgica).

Los valores válidos para esta propiedad son los siguientes:
  • cicfE – E
  • cicfKntEna, KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Es la clasificación del video del Consejo Nacional de lo Audiovisual (CNA) de Rumania.

Los valores válidos para esta propiedad son los siguientes:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus: Mayores de 18 años
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Sistema de clasificación en Francia: Commission de classification cinematographique

Los valores válidos para esta propiedad son los siguientes:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE, E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
La clasificación del video según el Conseil supérieur de l'audiovisuel de Francia, que clasifica el contenido de transmisión.

Los valores válidos para esta propiedad son los siguientes:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Interdicción
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
La clasificación del video según la Commission de surveillance de la classification des films (CSCF) de Luxemburgo.

Los valores válidos para esta propiedad son los siguientes:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl: AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
La clasificación del video en República Checa.

Los valores válidos para esta propiedad son los siguientes:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Es la clasificación del Departamento de Justicia, Clasificación, Calificación y Títulos (DJCQT) de Brasil del video.

Los valores válidos para esta propiedad son los siguientes:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Son los motivos que explican por qué el video recibió su clasificación de DJCQT (Brasil).
contentDetails.contentRating.ecbmctRating string
Sistema de clasificación de Turquía: Junta de Evaluación y Clasificación del Ministerio de Cultura y Turismo

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

Los valores válidos para esta propiedad son los siguientes:
  • eefilmK12: De preescolar a bachillerato
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – De preescolar a 6º grado
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6: MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Es la clasificación del video en Egipto.

Los valores válidos para esta propiedad son los siguientes:
  • egfilm18 – 18
  • egfilmBn, BN
  • egfilmGn, GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Es la clasificación de Eirin (映倫) del video. Eirin es el sistema de clasificación japonés.

Los valores válidos para esta propiedad son los siguientes:
  • eirinG – G
  • eirinPg12: PG-12
  • eirinR15plus: R15+
  • eirinR18plus: R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
La clasificación del video según la Junta de Censura Cinematográfica de Malasia.

Los valores válidos para esta propiedad son los siguientes:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl: 18PL
  • fcbm18sg: 18SG
  • fcbm18sx – 18SX
  • fcbmP12, P12
  • fcbmP13 – P13
  • fcbmPg13: PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
La clasificació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
  • fcoIii – 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 clasificación del video según el Centre national du cinéma et de l'image animé (Ministerio de Cultura de Francia).

Los valores válidos para esta propiedad son los siguientes:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
La clasificación del video según la Junta de Cine y Publicaciones de Sudáfrica.

Los valores válidos para esta propiedad son los siguientes:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg, PG
  • fpbUnrated
  • fpbX18, X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Son los motivos que explican por qué el video recibió su clasificación de la FPB (Sudáfrica).
contentDetails.contentRating.fskRating string
La clasificación de la 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 clasificación del video en Grecia.

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

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

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

Los valores válidos para esta propiedad son los siguientes:
  • incaaAtp: ATP (Apta para todo público)
  • incaaC: X (solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16: 16 (Solo apta para mayores de 16 años)
  • incaaSam18: Mayores de 18 años
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Es la clasificación del video del Kenya Film Classification Board.

Los valores válidos para esta propiedad son los siguientes:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg, PG
  • kfcbR – 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:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl: AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
La clasificación del video según la Junta de Clasificación de Medios de Corea (영상물등급위원회). La KMRB clasifica los videos en Corea del Sur.

Los valores válidos para esta propiedad son los siguientes:
  • kmrb12plus: Para mayores de 12 años
  • kmrb15plus: No apto para menores de 15 años
  • kmrbAll: 전체관람가
  • kmrbR: 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
La clasificación del video según el Lembaga Sensor Film de Indonesia.

Los valores válidos para esta propiedad son los siguientes:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Es la clasificación por edad de la película según la Film Age-Classification Board de Malta.

Los valores válidos para esta propiedad son los siguientes:
  • mccaa12 – 12
  • mccaa12a, 12A
  • mccaa14 – 14: Esta clasificación se quitó de la nueva estructura de clasificación que se introdujo en 2013.
  • mccaa15 – 15
  • mccaa16: 16 (esta clasificación se quitó de la nueva estructura de clasificación que se introdujo en 2013)
  • mccaa18 – 18
  • mccaaPg, PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Es la clasificación del video del Consejo de Medios para Niños y Jóvenes del Instituto Danés de Cine (Det Danske Filminstitut).

Los valores válidos para esta propiedad son los siguientes:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Sistema de clasificación de videos para Vietnam - MCST

Los valores válidos para esta propiedad son los siguientes:
  • mcst0 – 0
  • mcst16plus: Mayores de 16 años
  • mcstC13 – C13
  • mcstC16: C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13, T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
La clasificación del video de la Autoridad de Desarrollo de Medios (MDA) de Singapur y, específicamente, de su Junta de Censores de Películas (BFC).

Los valores válidos para esta propiedad son los siguientes:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16: NC16
  • mdaPg: PG
  • mdaPg13: PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
La clasificación del video según Medietilsynet, la Autoridad de Medios de Noruega.

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

Los valores válidos para esta propiedad son los siguientes:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
La clasificación del video según el 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 clasificación del video según el Ministerio de Cultura (Colombia).

Los valores válidos para esta propiedad son los siguientes:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7, 7
  • mocBanned: Bloqueado
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
La clasificación del video según el Ministerio de Cultura de Taiwán (文化部).

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

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

Los valores válidos para esta propiedad son los siguientes:
  • mpaatGb: GB (Green Band, aprobado para todo público)
  • mpaatRb: RB (Red Band, recomendado para mayores de 17 años)
contentDetails.contentRating.mtrcbRating string
La clasificación del video según la Junta de Clasificación y Revisión de Películas y Televisión (Filipinas).

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

Los valores válidos para esta propiedad son los siguientes:
  • nbc12plus: Mayores de 12 años
  • nbc15plus – 15+
  • nbc18plus: Mayores de 18 años
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg: PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Es la clasificación del video del Centro Nacional de Cine de Bulgaria.

Los valores válidos para esta propiedad son los siguientes:
  • nfrcA – A
  • nfrcB – B
  • nfrcC: C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
La clasificación del video según la Junta Nacional de Censores de Cine y Video de Nigeria.

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

Los valores válidos para esta propiedad son los siguientes:
  • nkclv12plus: Mayores de 12 años
  • nkclv18plus: Mayores de 18 años
  • nkclv7plus – 7+
  • nkclvU: U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
La clasificación de la Oficina de Clasificación de Cine y Literatura de Nueva Zelanda (OFLC) del video.

Los valores válidos para esta propiedad son los siguientes:
  • oflcG – G
  • oflcM – M
  • oflcPg: PG
  • oflcR13 – R13
  • oflcR15, R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16, RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Es la clasificación del video en Perú.

Los valores válidos para esta propiedad son los siguientes:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg, PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Es la clasificación del video en Venezuela.

Los valores válidos para esta propiedad son los siguientes:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC, C
  • resorteviolenciaD – D
  • resorteviolenciaE, E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
La clasificació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:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC, C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
Calificación del video de Raidió Teilifís Éireann de Irlanda.

Los valores válidos para esta propiedad son los siguientes:
  • rteCh – CH
  • rteGa – DG
  • rteMa, MA
  • rtePs, PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Es la clasificació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+
  • russia12: Mayores de 12 años
  • russia16: Mayores de 16 años
  • russia18: Mayores de 18 años
  • russia6: Mayores de 6 años
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Es la clasificación del video en Eslovaquia.

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

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

Los valores válidos para esta propiedad son los siguientes:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7, 7
  • smsaA: Todas las edades
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
La clasificación de las pautas de TV para los padres (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
Es una clasificación que YouTube usa 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 de miniatura personalizada para el video. Esta propiedad solo es visible para quien sube el video.
status object
El objeto status contiene información sobre los estados de carga, procesamiento y privacidad del video.
status.uploadStatus string
Es el estado del video subido.

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 falló la carga.

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
Es el estado de privacidad del video. En una solicitud videos.insert, si no especificas un valor para esta propiedad, el estado de privacidad del video subido se establece de forma predeterminada como public. Es posible que algunas cargas se establezcan de forma predeterminada como private según la configuración de la cuenta del creador, como se explica en el Centro de ayuda de YouTube. Los videos subidos desde proyectos de API sin verificar no se restringen al modo de visualización privada.

Los valores válidos para esta propiedad son los siguientes:
  • private
  • public
  • unlisted
status.publishAt datetime
Fecha y hora en que se programó la publicación del video. Solo se puede establecer si el estado de privacidad del video es privado. El valor se especifica en formato ISO 8601. Ten en cuenta los siguientes dos puntos adicionales sobre el comportamiento de esta propiedad:
  • Si estableces 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.
  • Esta propiedad solo se puede establecer si el estado de privacidad del video es private y el video nunca se publicó.
  • Si tu solicitud programa un video para que se publique en un momento del pasado, el video 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 el de cambiar el valor de 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 extendidas del video en la página de reproducción del video se pueden ver públicamente. De forma predeterminada, esas estadísticas se pueden ver, y las estadísticas como el recuento de vistas 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 se designó como dirigido a niños y contiene el estado actual de "creado para niños" del video. Por ejemplo, el estado se puede determinar según el valor de la propiedad selfDeclaredMadeForKids. Consulta el Centro de ayuda de YouTube para obtener más información sobre cómo configurar el público de tu canal, tus videos o tus transmisiones.
status.selfDeclaredMadeForKids boolean
En una solicitud videos.insert o videos.update, esta propiedad permite que el propietario del canal designe el video como dirigido a niños. En una solicitud videos.list, el valor de la propiedad solo se devuelve si el propietario del canal autorizó la solicitud a la API.
status.containsSyntheticMedia boolean
En una solicitud videos.insert o videos.update, esta propiedad permite que el propietario del canal divulgue que un video incluye contenido realista sintético o alterado (S/A). Obtén más información sobre las políticas de YouTube relacionadas con el contenido de A/S.

Estos son algunos ejemplos de contenido de A/S:
  • Hacer que una persona real parezca decir o hacer algo que no dijo o hizo
  • Alterar videos de acontecimientos o lugares reales
  • Generar una escena de aspecto realista que en realidad no ocurrió
statistics object
El objeto statistics contiene estadísticas sobre el video.
statistics.viewCount unsigned long

Cantidad de reproducciones del video.

A partir del 24 de agosto de 2026, para todos los formatos de video (formato largo, transmisiones en vivo y Shorts) de un canal, se actualizará viewCount para que las vistas se registren en cuanto se empiece a reproducir un video (incluye la reproducción automática, mantener el puntero sobre el video y hacer clic o presionar para reproducir).
statistics.likeCount unsigned long
Es la cantidad de usuarios que indicaron que les gustó el video.
statistics.dislikeCount unsigned long
Nota: La propiedad statistics.dislikeCount se volvió 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 revisiones para obtener más información.

Es 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 siempre se establece en 0.
statistics.commentCount unsigned long
Es la cantidad de comentarios del video.
paidProductPlacementDetails object
El objeto paidProductPlacementDetails contiene información sobre la colocación de productos pagada en el video.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Se establece en true si el contenido usa la colocación de producto pagada. La configuración predeterminada es false.
player object
El objeto player contiene información que usarías para reproducir el video en un reproductor integrado.
player.embedHtml string
Es una etiqueta <iframe> que incorpora un reproductor que reproduce el video.
  • Si la solicitud a la API para recuperar el recurso especifica un valor para los parámetros maxHeight o maxWidth, el tamaño del reproductor integrado se ajusta para satisfacer los requisitos de maxHeight o maxWidth.
  • Si se desconoce la relación de aspecto del video, el reproductor integrado se establece de forma predeterminada en un formato de 4:3.
player.embedHeight long
La altura del reproductor incorporado que se muestra en la propiedad player.embedHtml. Esta propiedad solo se devuelve 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
Ancho del reproductor incorporado que se muestra en la propiedad player.embedHtml. Esta propiedad solo se devuelve 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 encapsula información sobre los temas asociados con el video.

Importante: Consulta las definiciones de las propiedades topicDetails.relevantTopicIds[] y topicDetails.topicIds[], así como el historial de revisiones 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 devuelve valores para esta propiedad, y los temas asociados con un video ahora se devuelven con el valor de la propiedad topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Es una lista de IDs de temas que son 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 la baja de Freebase y la API de Freebase, los IDs de tema comenzaron a funcionar de manera diferente a partir del 27 de febrero de 2017. En ese momento, YouTube comenzó a mostrar un pequeño conjunto de IDs de temas seleccionados.
topicDetails.topicCategories[] list
Es una lista de URLs de Wikipedia que proporcionan una descripción general del contenido del video.
recordingDetails object
El objeto recordingDetails encapsula información sobre la ubicación, la fecha y la dirección en la que se grabó el video.
recordingDetails.locationDescription string
Esta propiedad dejó de estar disponible el 1 de junio de 2017. Consulta el anuncio de baja para obtener más detalles.

Es la descripción de texto de la ubicación donde se grabó el video.
recordingDetails.location object
Esta propiedad dejó de estar disponible. Todas sus propiedades secundarias (latitud, longitud y altitud) dejaron de estar disponibles.

Es la información de ubicación geográfica asociada con el video. Los valores de las propiedades secundarias identifican la ubicación que el propietario del video quiere asociar con el video. El valor se puede editar, se puede buscar en los videos públicos y es posible que se muestre a los usuarios en los videos públicos.
recordingDetails.location.latitude double
Esta propiedad dejó de estar disponible el 1 de junio de 2017. Consulta el anuncio de baja para obtener más detalles.

Es la latitud expresada 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 expresada en grados.
recordingDetails.location.altitude double
Esta propiedad dejó de estar disponible el 9 de julio de 2018. Consulta el anuncio de baja para obtener más detalles.

Altitud sobre el elipsoide de referencia, en metros.
recordingDetails.recordingDate datetime
Fecha y hora en que se grabó el video. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
El objeto fileDetails encapsula información sobre el archivo de video que se subió a YouTube, incluida la resolución, la duración, los códecs de audio y video, las tasas de bits de transmisión y mucho más. Estos datos solamente los puede recuperar el propietario del video.

El objeto fileDetails solo se devolverá si la propiedad processingDetails.fileAvailability tiene un valor de available.
fileDetails.fileName string
Es el nombre del archivo subido. Este campo está presente si se subió un archivo de video u otro tipo de archivo.
fileDetails.fileSize unsigned long
Es el tamaño del archivo subido en bytes. Este campo está presente si se subió un archivo de video u otro tipo de archivo.
fileDetails.fileType string
Es el tipo de archivo subido que detectó el motor de procesamiento de videos de YouTube. Actualmente, YouTube solo procesa archivos de video, pero este campo está presente independientemente de si se subió un archivo de video o de otro tipo.

Los valores válidos para esta propiedad son los siguientes:
  • 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 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
Es el formato de contenedor del archivo de video subido.
fileDetails.videoStreams[] list
Es una lista de transmisiones de video incluidas en el archivo de video subido. Cada elemento de la lista contiene metadatos detallados sobre una transmisión de video.
fileDetails.videoStreams[].widthPixels unsigned integer
Es el ancho del contenido de video codificado en píxeles. Puedes calcular la relación de aspecto de codificación del video como width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Altura del contenido de video codificado en píxeles.
fileDetails.videoStreams[].frameRateFps double
Es la velocidad de fotogramas de la transmisión de video, en fotogramas por segundo.
fileDetails.videoStreams[].aspectRatio double
Es 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
Es el códec de video que usa la transmisión.
fileDetails.videoStreams[].bitrateBps unsigned long
Es la tasa de bits de la transmisión de video, en bits por segundo.
fileDetails.videoStreams[].rotation string
Es la cantidad en la que YouTube debe rotar el contenido fuente original para mostrar el video correctamente.

Los valores válidos para esta propiedad son los siguientes:
  • clockwise: El video debe rotarse 90 grados en el sentido de las manecillas del reloj.
  • counterClockwise: El video debe rotarse 90 grados en el sentido contrario a las manecillas del reloj.
  • none: No es necesario rotar el video.
  • other: El video debe rotarse de alguna otra manera no trivial.
  • upsideDown: El video se debe rotar al revés.
fileDetails.videoStreams[].vendor string
Es un valor que identifica de forma única a un proveedor de videos. Normalmente, el valor es un código de proveedor de cuatro letras.
fileDetails.audioStreams[] list
Es una lista de las transmisiones de audio que contiene el archivo de video subido. Cada elemento de la lista contiene metadatos detallados sobre una transmisión continua de audio.
fileDetails.audioStreams[].channelCount unsigned integer
Es la cantidad de canales de audio que contiene la transmisión.
fileDetails.audioStreams[].codec string
Es el códec de audio que usa la transmisión.
fileDetails.audioStreams[].bitrateBps unsigned long
La tasa de bits de la transmisión de audio, en bits por segundo.
fileDetails.audioStreams[].vendor string
Es un valor que identifica de forma única a un proveedor de videos. Normalmente, el valor es un código de proveedor de cuatro letras.
fileDetails.durationMs unsigned long
Es la duración del video subido, expresada en milisegundos.
fileDetails.bitrateBps unsigned long
Es la tasa de bits combinada (video y audio) del archivo de video subido, en bits por segundo.
fileDetails.creationTime string
La fecha y hora en que se creó el archivo de video subido. El valor se especifica en formato ISO 8601. Actualmente, se admiten los siguientes formatos ISO 8601:
  • Solo fecha: YYYY-MM-DD
  • Hora ingenua: YYYY-MM-DDTHH:MM:SS
  • Hora con zona horaria: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
El objeto processingDetails encapsula información sobre el progreso de YouTube en el procesamiento del archivo de video subido. Las propiedades del objeto identifican el estado actual del proceso y una estimación del tiempo restante hasta que YouTube termine de procesar el video. Esta parte también indica si los diferentes tipos de datos o contenido, como detalles de los archivos o las imágenes en miniatura, están disponibles para el video.

El objeto processingProgress está diseñado para que se lo consulte de modo que el video subido pueda hacer un seguimiento del progreso que YouTube ha hecho en el procesamiento del archivo de video subido. Estos datos solamente los puede recuperar el propietario del video.
processingDetails.processingStatus string
Es el estado de procesamiento del video. Este valor indica si YouTube pudo procesar el video o si aún se está procesando.

Los valores válidos para esta propiedad son los siguientes:
  • failed: Se produjo un error en el procesamiento del video. ConsultaVer ProcessingFailureReason.
  • processing: El video se está procesando. 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 solo son relevantes si el estado de procesamiento del video es processing.
processingDetails.processingProgress.partsTotal unsigned long
Es una estimación de la cantidad total de partes que se deben procesar para el video. El número se puede actualizar con estimaciones más precisas, mientras YouTube procesa el video.
processingDetails.processingProgress.partsProcessed unsigned long
Es la cantidad de partes del video que YouTube ya procesó. Puedes estimar el porcentaje del video que YouTube ya procesó con el siguiente cálculo:
100 * parts_processed / parts_total

Ten en cuenta que, como 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
Es una estimación de la cantidad de tiempo, en milisegundos, que YouTube necesita para terminar de procesar el video.
processingDetails.processingFailureReason string
Es 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 algún otro componente de procesamiento.
  • streamingFailed: No se pudo enviar el video a los streamers.
  • transcodeFailed: No se pudo transcodificar el contenido.
  • uploadFailed: No se pudo entregar el archivo.
processingDetails.fileDetailsAvailability string
Este valor indica si los detalles del archivo están disponibles para el video subido. Para recuperar los detalles del archivo de un 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 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 videos.list().
processingDetails.tagSuggestionsAvailability string
Este valor indica si hay sugerencias de palabras clave (etiquetas) 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. Puedes recuperar estas sugerencias solicitando la parte suggestions en tu solicitud videos.list().
processingDetails.editorSuggestionsAvailability string
Este valor indica si hay sugerencias de edición de video disponibles para el video, las cuales podrían mejorar la calidad de video o la experiencia de reproducción. Para recuperar estas sugerencias, solicita la parte suggestions en tu solicitud videos.list().
processingDetails.thumbnailsAvailability string
Este valor indica si se generaron imágenes en miniatura para el video.
suggestions object
El objeto suggestions encapsula sugerencias que identifican oportunidades para mejorar la calidad del video o los metadatos del video subido. Estos datos solamente los puede recuperar el propietario del video.

El objeto suggestions solo se devolverá si la propiedad processingDetails.tagSuggestionsAvailability o la propiedad processingDetails.editorSuggestionsAvailability tienen un valor de available.
suggestions.processingErrors[] list
Es una lista de errores que impedirán que YouTube procese correctamente el video subido. Estos errores indican que, independientemente del estado de procesamiento actual del video, con el tiempo, ese estado será casi con certeza failed.

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

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 usó un códec de audio que se sabe que causa problemas.
  • problematicVideoCodec: Se usó un códec de video que se sabe que causa problemas.
  • unknownAudioCodec: Códec de audio no reconocido. Es probable que falle la transcodificación.
  • unknownContainer: No se reconoce el formato del archivo, por lo que es probable que falle la transcodificación.
  • unknownVideoCodec: Códec de video no reconocido. Es probable que falle la transcodificación.
suggestions.processingHints[] list
Es 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: Es probable que exista una versión de mejor calidad del video.
suggestions.tagSuggestions[] list
Es 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 lo encuentren cuando busquen o naveguen en YouTube.
suggestions.tagSuggestions[].tag string
Es la etiqueta de palabra clave sugerida para el video.
suggestions.tagSuggestions[].categoryRestricts[] list
Es un conjunto de categorías de video para las que 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
Es una lista de operaciones de edición de video que podrían mejorar la calidad del video o la experiencia de reproducción del video subido.

Los valores válidos para esta propiedad son los siguientes:
  • audioQuietAudioSwap: La pista de audio parece estar en silencio y se podría cambiar por una de mejor calidad.
  • videoAutoLevels: Los niveles de brillo de la imagen parecen incorrectos y se podrían corregir.
  • videoCrop: Es posible que se recorten los márgenes (mattes) detectados alrededor de la imagen.
  • videoStabilize: El video se ve tembloroso y podría estabilizarse.
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 próxima, en curso o completada.
liveStreamingDetails.actualStartTime datetime
Es la hora en la que realmente comenzó la transmisión. El valor se especifica en formato ISO 8601. Este valor no estará disponible hasta que comience la transmisión.
liveStreamingDetails.actualEndTime datetime
Es la hora en la que finalizó la transmisión. El valor se especifica en formato ISO 8601. Este valor no estará disponible hasta que finalice la transmisión.
liveStreamingDetails.scheduledStartTime datetime
Es la hora en la que se programó el inicio de la transmisión. El valor se especifica en formato ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Es la hora en la que se programó la finalización de la transmisión. El valor se especifica en formato ISO 8601. Si el valor está vacío o la propiedad no está presente, la transmisión se programa para que continúe de forma indefinida.
liveStreamingDetails.concurrentViewers unsigned long
Es la cantidad de usuarios que miran la transmisión en este momento. La propiedad y su valor estarán presentes si la transmisión tiene usuarios activos y el propietario de la transmisión no ocultó el recuento de vistas del video. Ten en cuenta que YouTube deja de hacer un seguimiento de la cantidad de usuarios 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 que miran el contenido simultáneamente que devuelve la API de YouTube Data podrían diferir de los recuentos procesados y sin spam que están disponibles en YouTube Analytics. Obtén más información sobre las métricas de las transmisiones en vivo en el Centro de ayuda de YouTube.
liveStreamingDetails.activeLiveChatId string
Es el ID del chat en vivo activo actualmente adjunto a este video. Este campo solo se completa si el video es una transmisión en vivo actual que tiene chat en vivo. Una vez que la transmisión pase a completarse, se quitará este campo y se cerrará el chat en vivo. En el caso de las transmisiones persistentes, el ID del chat en vivo ya no estará vinculado a este video, sino al nuevo video que se muestre en la página persistente.
brandPartner object
El objeto brandPartner contiene detalles sobre el socio de marca vinculado al video para el acceso para socios de marca iniciado por el creador (CI BPA).
brandPartner.channelId string
Es el ID del canal externo del socio de marca. Este campo debe comenzar con "UC". Se debe establecer channelId o channelHandle cuando se establece el acceso, pero solo se devuelve channelId en la respuesta.
brandPartner.channelHandle string
Es el identificador del canal del socio de marca. Este campo debe comenzar con "@". Se debe establecer channelId o channelHandle cuando se establece el acceso, pero solo se devuelve channelId en la respuesta.
localizations object
El objeto localizations contiene traducciones de los metadatos del video.
localizations.(key) object
Es el idioma del texto localizado asociado con el valor de la clave. El valor es una cadena que contiene un código de idioma BCP-47.
localizations.(key).title string
Es el título del video localizado.
localizations.(key).description string
Es la descripción localizada del video.