Videos

Tutti i video caricati tramite l'endpoint videos.insert da progetti API non verificati creati dopo il 28 luglio 2020 saranno limitati alla modalità di visualizzazione privata. Per rimuovere questa limitazione, ogni progetto API deve essere sottoposto a un controllo per verificare la conformità ai Termini di servizio. Consulta la cronologia delle revisioni delle API per ulteriori dettagli.

Una risorsa video rappresenta un video di YouTube.

Metodi

L'API supporta i seguenti metodi per le risorse di videos:

Ottieni valutazione
Recupera le valutazioni che l'utente autorizzato ha assegnato a un elenco di video specificati. Prova subito.
list
Restituisce un elenco di video che corrispondono ai parametri della richiesta API. Prova subito.
inserire
Carica un video su YouTube e, se vuoi, imposta i metadati del video.
Aggiorna
Aggiorna i metadati di un video. Prova subito.
elimina
Elimina un video di YouTube. Prova subito.
di frequenza
Aggiungi una valutazione Mi piace o Non mi piace a un video o rimuovi una valutazione da un video. Prova subito.
segnalare un comportamento illecito
Segnalare un video con contenuti illeciti. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa 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
    }
  }
}

Proprietà

La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#video.
etag etag
L'Etag di questa risorsa.
id string
L'ID utilizzato da YouTube per identificare in modo univoco il video.
snippet object
L'oggetto snippet contiene dettagli di base sul video, come titolo, descrizione e categoria.
snippet.publishedAt datetime
La data e l'ora in cui è stato pubblicato il video. Tieni presente che questa volta potrebbe essere diversa dall'ora in cui è stato caricato il video. Ad esempio, se un video viene caricato come privato e poi reso pubblico in un secondo momento, la proprietà specifica la data e l'ora in cui è stato reso pubblico.

Esistono un paio di casi speciali:
  • Se un video viene caricato come video privato e i metadati del video vengono recuperati dal proprietario del canale, il valore della proprietà indica la data e l'ora in cui è stato caricato.
  • Se un video viene caricato come video non in elenco, il valore della proprietà specifica anche la data e l'ora in cui è stato caricato. In questo caso, chiunque conosca l'ID video univoco del video può recuperare i metadati del video.
Il valore è specificato nel formato ISO 8601.
snippet.channelId string
L'ID utilizzato da YouTube per identificare in modo univoco il canale su cui è stato caricato il video.
snippet.title string
Il titolo del video. Il valore della proprietà ha una lunghezza massima di 100 caratteri e può contenere tutti i caratteri UTF-8 validi tranne < e >. Devi impostare un valore per questa proprietà se chiami il metodo videos.update e stai aggiornando la parte snippet di una risorsa video.
snippet.description string
La descrizione del video. Il valore della proprietà ha una lunghezza massima di 5000 byte e può contenere tutti i caratteri UTF-8 validi tranne < e >.
snippet.thumbnails object
Una mappa delle miniature associate al video. Per ogni oggetto nella mappa, la chiave è il nome dell'immagine in miniatura e il valore è un oggetto che contiene altre informazioni sulla miniatura.
snippet.thumbnails.(key) object
Le coppie chiave-valore valide sono:
  • default: l'immagine in miniatura predefinita. La miniatura predefinita di un video, o una risorsa che fa riferimento a un video, ad esempio una playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è larga 88 px e alta 88 px.
  • medium: una versione con una risoluzione più alta dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine è larga 240 px e alta 240 px.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine è larga 800 px e alta 800 px.
  • standard: una versione a risoluzione ancora più alta dell'immagine in miniatura rispetto a quella con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come elementi delle playlist o risultati di ricerca. Questa immagine ha una larghezza di 640 px e un'altezza di 480 px.
  • maxres: la versione con la risoluzione più alta dell'immagine in miniatura. Le dimensioni di questa immagine sono disponibili per alcuni video e altre risorse che fanno riferimento a video, ad esempio elementi delle playlist o risultati di ricerca. Questa immagine è larga 1280 px e alta 720 px.
snippet.thumbnails.(key).url string
L'URL dell'immagine.
snippet.thumbnails.(key).width unsigned integer
La larghezza dell'immagine.
snippet.thumbnails.(key).height unsigned integer
L'altezza dell'immagine.
snippet.channelTitle string
Titolo del canale a cui appartiene il video.
snippet.tags[] list
Un elenco di tag di parole chiave associati al video. I tag possono contenere spazi. Il valore della proprietà ha una lunghezza massima di 500 caratteri. Tieni presente le seguenti regole relative al modo in cui viene calcolato il limite di caratteri:
  • Il valore della proprietà è un elenco e le virgole tra gli elementi nell'elenco vengono conteggiate per il limite.
  • Se un tag contiene uno spazio, il server API gestisce il valore del tag come se fosse racchiuso tra virgolette e le virgolette vengono conteggiate per il limite di caratteri. Pertanto, ai fini del limite di caratteri, il tag Foo-Baz contiene sette caratteri, ma il tag Foo Baz contiene nove caratteri.
snippet.categoryId string
La categoria video di YouTube associata al video. Devi impostare un valore per questa proprietà se chiami il metodo videos.update e stai aggiornando la parte snippet di una risorsa video.
snippet.liveBroadcastContent string
Indica se il video è una trasmissione in diretta attiva/imminente. Oppure "non" se il video non è una trasmissione dal vivo attiva/in programma.

I valori validi per questa proprietà sono:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
La lingua del testo nelle proprietà snippet.title e snippet.description della risorsa video.
snippet.localized object
L'oggetto snippet.localized contiene un titolo localizzato e una descrizione per il video oppure il titolo nella lingua predefinita dei metadati del video.
  • Il testo localizzato viene restituito nello snippet di risorsa se la richiesta videos.list ha utilizzato il parametro hl per specificare una lingua per la quale deve essere restituito il testo localizzato e il testo localizzato è disponibile in quella lingua.
  • I metadati per la lingua predefinita vengono restituiti se non è stato specificato un valore parametro hl oppure se è stato specificato un valore, ma non sono disponibili metadati localizzati per la lingua specificata.
La proprietà contiene un valore di sola lettura. Utilizza l'oggetto localizations per aggiungere, aggiornare o eliminare titoli localizzati.
snippet.localized.title string
Il titolo del video localizzato.
snippet.localized.description string
La descrizione del video localizzata.
snippet.defaultAudioLanguage string
La proprietà default_audio_language specifica la lingua parlata nella traccia audio predefinita del video.
contentDetails object
L'oggetto contentDetails contiene informazioni sui contenuti video, incluse la durata del video e un'indicazione sulla disponibilità o meno dei sottotitoli.
contentDetails.duration string
La durata del video. Il valore della proprietà è una durata ISO 8601. Ad esempio, per un video che dura almeno un minuto e meno di un'ora, la durata è nel formato PT#M#S, in cui le lettere PT indicano che il valore specifica un periodo di tempo e le lettere M e S fanno riferimento rispettivamente alla durata in minuti e secondi. I caratteri # che precedono le lettere M e S sono entrambi numeri interi che specificano il numero di minuti (o secondi) del video. Ad esempio, un valore PT15M33S indica che il video dura 15 minuti e 33 secondi.

Se il video dura almeno un'ora, la durata è nel formato PT#H#M#S, in cui la # che precede la lettera H specifica la durata in ore del video e tutti gli altri dettagli sono uguali come descritto sopra. Se il video dura almeno un giorno, le lettere P e T sono separate e il valore è P#DT#H#M#S. Fai riferimento alla specifica ISO 8601 per i dettagli completi.
contentDetails.dimension string
Indica se il video è disponibile in 3D o in 2D.
contentDetails.definition string
Indica se il video è disponibile in alta definizione (HD) o solo in definizione standard.

I valori validi per questa proprietà sono:
  • hd
  • sd
contentDetails.caption string
Indica se i sottotitoli sono disponibili per il video.

I valori validi per questa proprietà sono:
  • false
  • true
contentDetails.licensedContent boolean
Indica se il video rappresenta contenuti con licenza, il che significa che i contenuti sono stati caricati su un canale collegato a un partner di contenuti di YouTube e poi rivendicati da tale partner.
contentDetails.regionRestriction object
L'oggetto regionRestriction contiene informazioni sui paesi in cui un video è visibile o meno. L'oggetto conterrà la proprietà contentDetails.regionRestriction.allowed o la proprietà contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Un elenco di codici regione che identificano i paesi in cui il video è visibile. Se questa proprietà è presente e un paese non è elencato nel relativo valore, il video non può essere visualizzato in quel paese. Se questa proprietà è presente e contiene un elenco vuoto, il video è bloccato in tutti i paesi.
contentDetails.regionRestriction.blocked[] list
Un elenco di codici regione che identificano i paesi in cui il video è bloccato. Se questa proprietà è presente e un paese non è elencato nel suo valore, il video è visibile in tale paese. Se questa proprietà è presente e contiene un elenco vuoto, il video è visibile in tutti i paesi.
contentDetails.contentRating object
Specifica le classificazioni ricevute dal video in base a vari schemi di valutazione.
contentDetails.contentRating.acbRating string
La classificazione dell'Australian Classification Board (ACB) o dell'Australian Communications and Media Authority (ACMA). Le classificazioni dell'ACMA vengono utilizzate per classificare la programmazione televisiva dei bambini.

I valori validi per questa proprietà sono:
  • acbC: programmi a cui è stata assegnata una classificazione C dall'Australian Communications and Media Authority. Questi programmi sono destinati ai bambini di età inferiore ai 14 anni (diversi dai bambini in età prescolare).
  • acbE - E
  • acbG - G
  • acbM - M
  • acbMa15plus - MA15+
  • acbP: programmi a cui è stata assegnata una classificazione P dall'Australian Communications and Media Authority. Questi programmi sono adatti ai bambini in età prescolare.
  • acbPg - PG
  • acbR18plus - Più di 18 anni
  • acbUnrated
contentDetails.contentRating.agcomRating string
La valutazione del video dell'Autorità per le Garanzie nelle Comunicazioni (AGCOM) italiana.

I valori validi per questa proprietà sono:
  • agcomT - T
  • agcomUnrated
  • agcomVm14 - VM14
  • agcomVm18 - VM18
contentDetails.contentRating.anatelRating string
La valutazione Anatel (Asociación Nacional de Televisión) del video per la televisione cilena.

I valori validi per questa proprietà sono:
  • anatelA - A
  • anatelF - F
  • anatelI - I
  • anatelI10 - I-10
  • anatelI12 - I-12
  • anatelI7 - I-7
  • anatelR - R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
La valutazione del BBFC (Video Board of Film Classification) del video.

I valori validi per questa proprietà sono:
  • bbfc12-12
  • bbfc12a-12 A
  • bbfc15-15
  • bbfc18-18
  • bbfcPg - PG
  • bbfcR18 - R18
  • bbfcU - U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
La valutazione del video dal Board of Film and Video Censors della Thailandia.

I valori validi per questa proprietà sono:
  • bfvc13-13
  • bfvc15-15
  • bfvc18-18
  • bfvc20-20
  • bfvcB - B
  • bfvcE - E
  • bfvcG - G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
La valutazione del video dell'Austrian Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur).

I valori validi per questa proprietà sono:
  • bmukk10-10+
  • Da bmukk12 a 12 anni o più
  • bmukk14-14+
  • bmukk16-16+
  • bmukk6 - 6+
  • Da bmukk8 a 8 anni o più
  • bmukkAa - Senza restrizioni
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Sistema di classificazione delle TV canadesi - Sistema di classificazione delle TV canadesi Valutazione del video dalla Canadian Radio-Television and Telecommunications Commission (CRTC) per le trasmissioni in inglese canadese. Per scoprire di più, visita il sito web del Canadian Broadcast Standards Council.

I valori validi per questa proprietà sono:
  • catv14plus-14+
  • catv18plus-18+
  • catvC - C
  • catvC8 - C8
  • catvG - G
  • catvPg - PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
La valutazione del video dalla Canadian Radio-Television and Telecommunications Commission (CRTC) per le trasmissioni in lingua canadese. Per scoprire di più, visita il sito web del Canadian Broadcast Standards Council.

I valori validi per questa proprietà sono:
  • catvfr13plus - 13+
  • catvfr16plus-16+
  • catvfr18plus-18+
  • Da catvfr8plus a 8 anni o più
  • catvfrG - G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Valutazione del video del Central Board of Film Certification (CBFC - India).

I valori validi per questa proprietà sono:
  • cbfcA - A
  • cbfcS - S
  • cbfcU - U
  • cbfcUnrated
  • cbfcUA - U/A
  • cbfcUA7plus - U/A
  • cbfcUA13plus - U/A
  • cbfcUA16plus - U/A
contentDetails.contentRating.cccRating string
Valutazione del Consejo de Calificación Cinematográfica (Cile) del video.

I valori validi per questa proprietà sono:
  • ccc14-14+
  • ccc18-18+
  • ccc18s - 18+ - contenido pornográfico
  • ccc18v - 18+ - contenido ecesivamente violento
  • ccc6 - 6+ - Inconveniente para menores de 7 años
  • cccTe - Specista
  • cccUnrated
contentDetails.contentRating.cceRating string
La valutazione del video dalla Comissão de Classificação de Espect 'culos del Portogallo.

I valori validi per questa proprietà sono:
  • cceM12-12
  • cceM14-14
  • cceM16-16
  • cceM18-18
  • cceM4-4
  • cceM6-6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
La valutazione del video in Svizzera.

I valori validi per questa proprietà sono:
  • chfilm0-0
  • chfilm12-12
  • chfilm16-16
  • chfilm18-18
  • chfilm6-6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
La valutazione del sistema CHVRS (Canadian Home Video Rating System) del video.

I valori validi per questa proprietà sono:
  • chvrs14a-14 A
  • chvrs18a-18 A
  • chvrsE - E
  • chvrsG - G
  • chvrsPg - PG
  • chvrsR - R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
La valutazione del video della Commission de Contrôle des Films (Belgio).

I valori validi per questa proprietà sono:
  • cicfE - E
  • cicfKntEna - KNT/ENA
  • cicfKtEa - KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
La valutazione del video dalla CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) della Romania.

I valori validi per questa proprietà sono:
  • cna12-12
  • cna15-15
  • cna18-18
  • cna18plus-18+
  • cnaAp - AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Sistema di classificazione in Francia - Commission de classificazione cinematographique

I valori validi per questa proprietà sono:
  • cnc10-10
  • cnc12-12
  • cnc16-16
  • cnc18-18
  • cncE - E
  • cncT - T
  • cncUnrated
contentDetails.contentRating.csaRating string
La valutazione del video del Conseil supérieur de l?audiovisuel francese, che valuta i contenuti trasmessi.

I valori validi per questa proprietà sono:
  • csa10-10
  • csa12-12
  • csa16-16
  • csa18-18
  • csaInterdiction - Interdizione
  • csaT - T
  • csaUnrated
contentDetails.contentRating.cscfRating string
La valutazione del video della Commissione di sorveglianza della classificazione dei film (CSCF) di Lussemburgo.

I valori validi per questa proprietà sono:
  • cscf12-12
  • cscf16-16
  • cscf18-18
  • cscf6-6
  • cscf9-9
  • cscfA - A
  • cscfAl - AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Valutazione del video nella Repubblica Ceca.

I valori validi per questa proprietà sono:
  • czfilm12-12
  • czfilm14-14
  • czfilm18-18
  • czfilmU - U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Classifica del video di Directionamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasile).

Ecco i valori validi per questa proprietà:
  • djctq10-10
  • djctq12-12
  • djctq14-14
  • djctq16-16
  • djctq18-18
  • djctqL - L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
I motivi per cui il video ha ricevuto la valutazione DJCQT (Brasile).
contentDetails.contentRating.ecbmctRating string
Sistema di classificazione in Turchia - Consiglio di valutazione e classificazione del Ministero della cultura e del turismo

I valori validi per questa proprietà sono:
  • ecbmct13a-13 A
  • ecbmct13plus - 13+
  • ecbmct15a-15 A
  • ecbmct15plus - 15+
  • ecbmct18plus-18+
  • ecbmct7a-7A
  • ecbmct7plus - 7+
  • ecbmctG - G
  • ecbmctUnrated
  • ecbmct6a-6A
  • ecbmct6plus - 6+
  • ecbmct10a-10 A
  • ecbmct10plus-10+
  • ecbmct16plus-16+
contentDetails.contentRating.eefilmRating string
La valutazione del video in Estonia.

I valori validi per questa proprietà sono:
  • eefilmK12 - istruzione primaria e secondaria
  • eefilmK14 - istruzione primaria e secondaria
  • eefilmK16 - istruzione primaria e secondaria
  • eefilmK6 - istruzione primaria e secondaria
  • eefilmL - L
  • eefilmMs12 - MS-12
  • eefilmMs6 - MS-6
  • eefilmPere - Père
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Classificazione del video in Egitto.

I valori validi per questa proprietà sono:
  • egfilm18-18
  • egfilmBn - BN
  • egfilmGn - GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
La classificazione del video di Eirin (映倫). Eirin è il sistema di valutazione giapponese.

I valori validi per questa proprietà sono:
  • eirinG - G
  • eirinPg12 - PG-12
  • eirinR15plus - Più di 15 R
  • eirinR18plus - Più di 18 anni
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
La valutazione del video del Film Censorship Board della Malaysia.

I valori validi per questa proprietà sono:
  • fcbm18-18
  • fcbm18pa-18 PA
  • fcbm18pl - 18 PL
  • fcbm18sg - 18 SG
  • fcbm18sx - 18SX
  • fcbmP13 - P13
  • fcbmPg13 - PG 13
  • fcbmU - U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
La valutazione del video dell'Ufficio di cinema, giornali e articoli di Hong Kong.

I valori validi per questa proprietà sono:
  • fcoI - I
  • fcoIi - II
  • fcoIia - IIA
  • fcoIib - IIB
  • fcoIii - III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Questa proprietà è stata ritirata il 2 novembre 2015. Usa la proprietà contentDetails.contentRating.cncRating.

La valutazione del Centre national du cinéma et de l'image animé (Ministero della cultura francese) del video.

I valori validi per questa proprietà sono:
  • fmoc10-10
  • fmoc12-12
  • fmoc16-16
  • fmoc18-18
  • fmocE - E
  • fmocU - U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
La valutazione del video del Film and Publication Board del Sudafrica.

I valori validi per questa proprietà sono:
  • fpb10-10
  • fpb1012Pg - 10-12 PG
  • fpb13-13
  • fpb16-16
  • fpb18-18
  • fpb79Pg - 7-9 PG
  • fpbA - A
  • fpbPg - PG
  • fpbUnrated
  • fpbX18 - X18
  • fpbXx-XX
contentDetails.contentRating.fpbRatingReasons[] list
I motivi per cui il video ha ricevuto la classificazione FPB (Sudafrica).
contentDetails.contentRating.fskRating string
Valutazione del video Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germania).

I valori validi per questa proprietà sono:
  • fsk0 - 0 FSK
  • fsk12 - 12 FSK
  • fsk16 - 16 FSK
  • fsk18 - 18 FSK
  • fsk6 - 6 FSK
  • fskUnrated
contentDetails.contentRating.grfilmRating string
La valutazione del video in Grecia.

I valori validi per questa proprietà sono:
  • grfilmE - E
  • grfilmK-K
  • grfilmK12 - istruzione primaria e secondaria
  • grfilmK13 - istruzione primaria e secondaria
  • grfilmK15 - istruzione primaria e secondaria
  • grfilmK17 - istruzione primaria e secondaria
  • grfilmK18 - istruzione primaria e secondaria
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
La valutazione dell'Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spagna) del video.

I valori validi per questa proprietà sono:
  • icaa12-12
  • icaa13-13
  • icaa16-16
  • icaa18-18
  • icaa7-7
  • icaaApta - APTA
  • icaaUnrated
  • icaaX - X
contentDetails.contentRating.ifcoRating string
La classificazione del video del Irish Film Classification Office (IFCO - Irlanda). Per scoprire di più, visita il sito web IFCO.

I valori validi per questa proprietà sono:
  • ifco12-12
  • ifco12a-12 A
  • ifco15-15
  • ifco15a-15 A
  • ifco16-16
  • ifco18-18
  • ifcoG - G
  • ifcoPg - PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
La valutazione del video in Israele.

I valori validi per questa proprietà sono:
  • ilfilm12-12
  • ilfilm16-16
  • ilfilm18-18
  • ilfilmAa - AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Valutazione dell'Instituto Nacional de Cine y Artes Audiovisuales - Argentina del video.

I valori validi per questa proprietà sono:
  • incaaAtp - ATP (Apta para todo publico)
  • 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 - 18 (Solo apta para Mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
La valutazione del video della Kenya Film Classification Board.

I valori validi per questa proprietà sono:
  • kfcb16plus-16
  • kfcbG - GE
  • kfcbPg - PG
  • kfcbR-18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Paesi Bassi).

I valori validi per questa proprietà sono:
  • kijkwijzer12-12
  • kijkwijzer16-16
  • kijkwijzer18-18
  • kijkwijzer6-6
  • kijkwijzer9-9
  • kijkwijzerAl - AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
La valutazione del Media Media Rating Board (영상물등台วว회) nel video. La KMRB valuta i video in Corea del Sud.

I valori validi per questa proprietà sono:
  • kmrb12plus - 12 OneBox scribe상 관람型
  • kmrb15plus - 15 gennaio scribe상 관람型
  • kmrbAll – 민체관람型
  • kmrbR - 청소년 관람불台
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
La valutazione del video dalla pellicola per sensori di Lembaga in Indonesia.

I valori validi per questa proprietà sono:
  • lsf13-13
  • lsf17-17
  • lsf21-21
  • lsfA - A
  • lsfBo - BO
  • lsfD - D
  • lsfR - R
  • lsfSu - GI
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
La valutazione del video della Film Age Classification Board di Malta.

I valori validi per questa proprietà sono:
  • mccaa12-12
  • mccaa12a-12 A
  • mccaa14 - 14 - questa valutazione è stata rimossa dalla nuova struttura di classificazione introdotta nel 2013.
  • mccaa15-15
  • mccaa16 - 16 - questa valutazione è stata rimossa dalla nuova struttura di classificazione introdotta nel 2013.
  • mccaa18-18
  • mccaaPg - PG
  • mccaaU - U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
La valutazione del video del Media Film Institute (Dat Danske Filminstitut) Media Council for Children and Young People dell'istituto danese.

I valori validi per questa proprietà sono:
  • mccyp11-11
  • mccyp15-15
  • mccyp7-7
  • mccypA - A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Il sistema di valutazione del video per il Vietnam - MCST

I valori validi per questa proprietà sono:
  • mcst0-0
  • mcst16plus-16+
  • mcstC13 - C13
  • mcstC16 - C16
  • mcstC18 - C18
  • mcstP - P
  • mcstUnrated
contentDetails.contentRating.mdaRating string
La valutazione del video dall'MDA (Media Development Authority) di Singapore e, in particolare, dal Board of Film Censors (BFC).

I valori validi per questa proprietà sono:
  • mdaG - G
  • mdaM18 - M18
  • mdaNc16 - NC 16
  • mdaPg - PG
  • mdaPg13 - PG 13
  • mdaR21 - R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
La valutazione del video di Medietilsynet, l'autorità di comunicazione norvegese.

I valori validi per questa proprietà sono:
  • medietilsynet11-11
  • medietilsynet12-12
  • medietilsynet15-15
  • medietilsynet18-18
  • medietilsynet6-6
  • medietilsynet7-7
  • medietilsynet9-9
  • medietilsynetA - A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
La valutazione del video del Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) finlandese.

I valori validi per questa proprietà sono:
  • meku12-12
  • meku16-16
  • meku18-18
  • meku7-7
  • mekuS - S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
La valutazione del video dal Ministero dei Beni e dalle Attività Culturali e del Turismo (Italia).

I valori validi per questa proprietà sono:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Valutazione del Ministerio de Cultura (Colombia) per il video.

I valori validi per questa proprietà sono:
  • moc12-12
  • moc15-15
  • moc18-18
  • moc7-7
  • mocBanned - Esclusione
  • mocE - E
  • mocT - T
  • mocUnrated
  • mocX - X
contentDetails.contentRating.moctwRating string
Valutazione del video del Ministero della Cultura di Taiwan (文化部).

I valori validi per questa proprietà sono:
  • moctwG - G
  • moctwP - P
  • moctwPg - PG
  • moctwR - R
  • moctwR12 - R-12
  • moctwR15 - R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
La classificazione della Motion Picture Association of America (MPAA) del video.

I valori validi per questa proprietà sono:
  • mpaaG - G
  • mpaaNc17 - NC-17
  • mpaaPg - PG
  • mpaaPg13 - PG-13
  • mpaaR - R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
La valutazione della Motion Picture Association of America relativa ai trailer dei film e alla relativa anteprima.

I valori validi per questa proprietà sono:
  • mpaatGb - GB (Banda verde - Approvato per tutti i segmenti di pubblico)
  • mpaatRb - RB (banda rossa - Età consigliata: 17+)
contentDetails.contentRating.mtrcbRating string
La valutazione del video del Film and Television Review and Classification Board (Filippine).

I valori validi per questa proprietà sono:
  • mtrcbG - G
  • mtrcbPg - PG
  • mtrcbR13 - R-13
  • mtrcbR16 - R-16
  • mtrcbR18 - R-18
  • mtrcbUnrated
  • mtrcbX - X
contentDetails.contentRating.nbcRating string
La valutazione del video del Maldives National Bureau of Classification.

I valori validi per questa proprietà sono:
  • Da nbc12plus a 12 anni o più
  • nbc15plus - 15+
  • nbc18plus-18+
  • nbc18plusr-18+R
  • nbcG - G
  • nbcPg - PG
  • nbcPu - PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
La valutazione del video del Bulgarian National Film Center.

I valori validi per questa proprietà sono:
  • nfrcA - A
  • nfrcB - B
  • nfrcC - C
  • nfrcD - D
  • nfrcUnrated
  • nfrcX - X
contentDetails.contentRating.nfvcbRating string
La valutazione del video della National Film and Video Censors Board della Nigeria.

I valori validi per questa proprietà sono:
  • nfvcb12-12
  • nfvcb12a-12 A
  • nfvcb15-15
  • nfvcb18-18
  • nfvcbG - G
  • nfvcbPg - PG
  • nfvcbRe - RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
La valutazione del video dal Nacionãlais Kino centrs (Centro nazionale dei film della Lettonia).

I valori validi per questa proprietà sono:
  • Da nkclv12plus a 12 anni o più
  • nkclv18plus-18+
  • nkclv7plus - 7+
  • nkclvU - U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
La classificazione dell'Ufficio di film e letteratura (OFLC - Nuova Zelanda) del video.

I valori validi per questa proprietà sono:
  • oflcG - G
  • oflcM - M
  • oflcPg - PG
  • oflcR13 - 13 R
  • oflcR15 - 15 R
  • oflcR16 - 16 R
  • oflcR18 - R18
  • oflcRp13 - RP13
  • oflcRp16 - RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
La valutazione del video in Perù.

I valori validi per questa proprietà sono:
  • pefilm14-14
  • pefilm18-18
  • pefilmPg - PG
  • pefilmPt - PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
La valutazione del video in Venezuela.

I valori validi per questa proprietà sono:
  • resorteviolenciaA - A
  • resorteviolenciaB - B
  • resorteviolenciaC - C
  • resorteviolenciaD - D
  • resorteviolenciaE - E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
La valutazione della direzione generale di radio, televisione e cinematografia (Messico) del video.

I valori validi per questa proprietà sono:
  • rtcA - A
  • rtcAa - AA
  • rtcB - B
  • rtcB15 - B15
  • rtcC - C
  • rtcD - D
  • rtcUnrated
contentDetails.contentRating.rteRating string
La valutazione del video di Raidió Teilifís Éireann in Irlanda.

I valori validi per questa proprietà sono:
  • rteCh - CH
  • rteGa - GA
  • rteMa - MA
  • rtePs - PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
La classificazione del video del National Film Registry of the Russia Federation (MKRF - Russia).

I valori validi per questa proprietà sono:
  • russia0 - 0+
  • Da russia12 a 12 anni o più
  • russia16-16+
  • russia18-18+
  • russia6 - 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
La valutazione del video in Slovacchia.

I valori validi per questa proprietà sono:
  • skfilmG - G
  • skfilmP2 - P2
  • skfilmP5-P5
  • skfilmP8 - P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
La valutazione del video in Islanda.

I valori validi per questa proprietà sono:
  • smais12-12
  • smais14-14
  • smais16-16
  • smais18-18
  • smais7-7
  • smaisL - L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
La valutazione del video dello Statens mediaråd (National Media Council) della Svezia.

I valori validi per questa proprietà sono:
  • smsa11-11
  • smsa15-15
  • smsa7-7
  • smsaA - Tutte le età
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Classificazione del video TV Parental Guidelines (TVPG).

I valori validi per questa proprietà sono:
  • 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 classificazione utilizzata da YouTube per identificare i contenuti soggetti a limiti di età.

I valori validi per questa proprietà sono:
  • ytAgeRestricted
contentDetails.projection string
Specifica il formato di proiezione del video.

I valori validi per questa proprietà sono:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Indica se l'utente che ha caricato il video ha fornito una miniatura personalizzata per il video. Questa proprietà è visibile soltanto all'utente che ha caricato il video.
status object
L'oggetto status contiene informazioni sugli stati di caricamento, elaborazione e privacy del video.
status.uploadStatus string
Lo stato del video caricato.

I valori validi per questa proprietà sono:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Questo valore spiega il motivo per cui non è stato possibile caricare un video. Questa proprietà è presente solo se la proprietà uploadStatus indica che il caricamento non è riuscito.

I valori validi per questa proprietà sono:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Questo valore spiega perché YouTube ha rifiutato un video caricato. Questa proprietà è presente solo se la proprietà uploadStatus indica che il caricamento è stato rifiutato.

I valori validi per questa proprietà sono:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Lo stato della privacy del video.

I valori validi per questa proprietà sono:
  • private
  • public
  • unlisted
status.publishAt datetime
La data e l'ora in cui è prevista la pubblicazione del video. Può essere impostato solo se lo stato di privacy del video è privato. Il valore è specificato nel formato ISO 8601. Tieni presente i due punti aggiuntivi sul comportamento di questa proprietà:
  • Se imposti il valore di questa proprietà durante la chiamata al metodo videos.update, devi impostare il valore della proprietà status.privacyStatus anche su private anche se il video è già privato.
  • Se la tua richiesta pianifica la pubblicazione di un video in un determinato momento in passato, verrà pubblicato immediatamente. Pertanto, l'impostazione della proprietà status.publishAt su una data e un'ora passate equivale a modificare la privacyStatus del video da private a public.
status.license string
La licenza del video.

I valori validi per questa proprietà sono:
  • creativeCommon
  • youtube
status.embeddable boolean
Questo valore indica se il video può essere incorporato in un altro sito web.
status.publicStatsViewable boolean
Questo valore indica se le statistiche video estese nella pagina di visualizzazione del video sono visibili al pubblico. Per impostazione predefinita, tali statistiche sono visualizzabili e le statistiche come il numero di visualizzazioni e le valutazioni di un video saranno ancora visibili pubblicamente anche se il valore di questa proprietà è impostato su false.
status.madeForKids boolean
Questo valore indica se il video è classificato come rivolto ai minori e contiene lo stato attuale "destinato ai bambini". Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Consulta il Centro assistenza YouTube per ulteriori informazioni su come impostare il pubblico per il tuo canale, i tuoi video o le tue trasmissioni.
status.selfDeclaredMadeForKids boolean
In una richiesta videos.insert o videos.update, questa proprietà consente al proprietario del canale di designare il video come rivolto ai minori. In una richiesta videos.list, il valore della proprietà viene restituito solo se il proprietario del canale ha autorizzato la richiesta API.
statistics object
L'oggetto statistics contiene statistiche sul video.
statistics.viewCount unsigned long
Il numero di volte in cui il video è stato visualizzato.
statistics.likeCount unsigned long
Il numero di utenti che hanno indicato di apprezzare il video.
statistics.dislikeCount unsigned long
Nota: la proprietà statistics.dislikeCount è stata impostata come privata a partire dal 13 dicembre 2021. Ciò significa che la proprietà viene inclusa in una risposta API solo se la richiesta API è stata autenticata dal proprietario del video. Per saperne di più, consulta la cronologia delle revisioni.

Il numero di utenti che hanno indicato di non apprezzare il video.
statistics.favoriteCount unsigned long
Nota: questa proprietà è stata ritirata. Il ritiro entrerà in vigore il 28 agosto 2015. Ora il valore della proprietà è sempre impostato su 0.
statistics.commentCount unsigned long
Il numero di commenti per il video.
player object
L'oggetto player contiene informazioni che puoi utilizzare per riprodurre il video in un player incorporato.
player.embedHtml string
Un tag <iframe> che incorpora un player che riproduce il video.
  • Se la richiesta API per recuperare la risorsa specifica un valore per i parametri maxHeight e/o maxWidth, le dimensioni del player incorporato vengono adeguate per soddisfare i requisiti di maxHeight e/o maxWidth.
  • Se le proporzioni del video sono sconosciute, il formato predefinito del player incorporato è 4:3.
player.embedHeight long
L'altezza del player incorporato è stata restituita nella proprietà player.embedHtml. Questa proprietà viene restituita solo se la richiesta ha specificato un valore per i parametri maxHeight e/o maxWidth e le proporzioni del video sono note.
player.embedWidth long
La larghezza del player incorporato è stata restituita nella proprietà player.embedHtml. Questa proprietà viene restituita solo se la richiesta ha specificato un valore per i parametri maxHeight e/o maxWidth e le proporzioni del video sono note.
topicDetails object
L'oggetto topicDetails include informazioni sugli argomenti associati al video.

Importante: per ulteriori dettagli sulle imminenti modifiche relative agli ID argomento, consulta le definizioni delle proprietà topicDetails.relevantTopicIds[] e topicDetails.topicIds[], nonché la cronologia delle revisioni.
topicDetails.topicIds[] list
Importante: questa proprietà è stata ritirata il 10 novembre 2016. L'API non restituisce più valori per questa proprietà e tutti gli argomenti associati a un video vengono ora restituiti dal valore della proprietà topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Un elenco di ID argomento pertinenti al video.

Questa proprietà è stata ritirata il 10 novembre 2016. Sarà supportato fino al 10 novembre 2017.

Importante:a causa del ritiro di Freebase e dell'API Freebase, gli ID argomento hanno iniziato a funzionare in modo diverso a partire dal 27 febbraio 2017. In quel periodo, YouTube ha iniziato a restituire un piccolo insieme di ID argomento selezionato.

topicDetails.topicCategories[] list
Un elenco di URL di Wikipedia che forniscono una descrizione generale dei contenuti del video.
recordingDetails object
L'oggetto recordingDetails include informazioni sulla località, sulla data e sull'indirizzo in cui è stato registrato il video.
recordingDetails.locationDescription string
Questa proprietà è stata ritirata il 1° giugno 2017. Per maggiori dettagli, leggi la comunicazione relativa al ritiro.

La descrizione testuale del luogo in cui è stato registrato il video.
recordingDetails.location object
Le informazioni di geolocalizzazione associate al video. Tieni presente che i valori della proprietà secondaria identificano la posizione che il proprietario del video vuole associare al video. Il valore è modificabile, disponibile per la ricerca sui video pubblici e potrebbe essere mostrato agli utenti per i video pubblici.
recordingDetails.location.latitude double
Questa proprietà è stata ritirata il 1° giugno 2017. Per maggiori dettagli, leggi la comunicazione relativa al ritiro.

Latitudine in gradi.
recordingDetails.location.longitude double
Questa proprietà è stata ritirata il 1° giugno 2017. Per maggiori dettagli, leggi la comunicazione relativa al ritiro.

Longitudine in gradi.
recordingDetails.location.altitude double
Questa proprietà è stata ritirata il 9 luglio 2018. Per maggiori dettagli, leggi la comunicazione relativa al ritiro.

Altitudine sopra l'ellissoide di riferimento, in metri.
recordingDetails.recordingDate datetime
La data e l'ora in cui è stato registrato il video. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
L'oggetto fileDetails include informazioni sul file video caricato su YouTube, tra cui la risoluzione, la durata, i codec audio e video, la velocità in bit dello stream e altro ancora. Questi dati possono essere recuperati solo dal proprietario del video.

L'oggetto fileDetails verrà restituito solo se la proprietà processingDetails.fileAvailability ha un valore available.
fileDetails.fileName string
Il nome del file caricato. Questo campo è presente se è stato caricato un file video o un altro tipo di file.
fileDetails.fileSize unsigned long
Le dimensioni del file caricato in byte. Questo campo è presente se è stato caricato un file video o un altro tipo di file.
fileDetails.fileType string
Il tipo del file caricato rilevato dal motore di elaborazione video di YouTube. Attualmente, YouTube elabora solo i file video, ma questo campo è presente se è stato caricato un file video o un altro tipo di file.

I valori validi per questa proprietà sono:
  • archive: il file è un file di archivio, ad esempio un archivio ZIP.
  • audio: il file è un tipo di file audio noto, ad esempio un file .mp3.
  • document: il file è un documento o un file di testo, ad esempio un file di MS Word.
  • image: il file è un file immagine, ad esempio un'immagine .jpeg.
  • other: il file è un altro tipo di file non video.
  • project: il file è un progetto video, ad esempio un progetto di Microsoft Windows Movie Maker, che non contiene dati video effettivi.
  • video: il file è un tipo di file video noto, ad esempio un file .mp4.
fileDetails.container string
Il formato del contenitore del file video caricato.
fileDetails.videoStreams[] list
Un elenco di video stream contenuti nel file video caricato. Ogni elemento dell'elenco contiene metadati dettagliati relativi a un video stream.
fileDetails.videoStreams[].widthPixels unsigned integer
La larghezza in pixel dei contenuti video codificati. Puoi calcolare le proporzioni di codifica di width_pixels height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
L'altezza in pixel dei contenuti video codificati.
fileDetails.videoStreams[].frameRateFps double
La frequenza fotogrammi del video stream, in frame al secondo.
fileDetails.videoStreams[].aspectRatio double
Le proporzioni di visualizzazione dei contenuti video, che specificano le proporzioni in cui il video deve essere visualizzato.
fileDetails.videoStreams[].codec string
Il codec video utilizzato dallo stream.
fileDetails.videoStreams[].bitrateBps unsigned long
La velocità in bit del video stream, in bit per secondo.
fileDetails.videoStreams[].rotation string
La quantità di cui deve disporre YouTube per la rotazione dei contenuti originali per visualizzare correttamente il video.

I valori validi per questa proprietà sono:
  • clockwise: il video deve essere ruotato di 90 gradi in senso orario.
  • counterClockwise: il video deve essere ruotato di 90 gradi in senso antiorario.
  • none: il video non deve essere ruotato.
  • other: il video deve essere ruotato in modo non banale.
  • upsideDown: il video deve essere ruotato capovolto.
fileDetails.videoStreams[].vendor string
Un valore che identifica in modo univoco un fornitore di video. Solitamente, il valore è un codice di quattro lettere del fornitore.
fileDetails.audioStreams[] list
Un elenco di stream audio contenuti nel file video caricato. Ogni voce dell'elenco contiene metadati dettagliati relativi a uno stream audio.
fileDetails.audioStreams[].channelCount unsigned integer
Il numero di canali audio contenuti nello stream.
fileDetails.audioStreams[].codec string
Il codec audio utilizzato dallo stream.
fileDetails.audioStreams[].bitrateBps unsigned long
La velocità in bit dello stream audio, in bit al secondo.
fileDetails.audioStreams[].vendor string
Un valore che identifica in modo univoco un fornitore di video. Solitamente, il valore è un codice di quattro lettere del fornitore.
fileDetails.durationMs unsigned long
La durata del video caricato in millisecondi.
fileDetails.bitrateBps unsigned long
La velocità in bit combinata (video e audio) del file video caricato al secondo.
fileDetails.creationTime string
La data e l'ora in cui è stato creato il file video caricato. Il valore è specificato nel formato ISO 8601. Attualmente sono supportati i seguenti formati ISO 8601:
  • Solo data: YYYY-MM-DD
  • Ora ingenua: YYYY-MM-DDTHH:MM:SS
  • Ora con fuso orario: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
L'oggetto processingDetails include informazioni sull'avanzamento di YouTube nell'elaborazione del file video caricato. Le proprietà nell'oggetto identificano lo stato di elaborazione attuale e una stima del tempo rimanente prima che YouTube termini l'elaborazione del video. Questa parte indica anche se sono disponibili diversi tipi di dati o contenuti, come dettagli di file o miniature.

L'oggetto processingProgress è progettato per essere sottoposto a sondaggio in modo che il video caricato possa monitorare i progressi compiuti da YouTube nell'elaborazione del file video caricato. Questi dati possono essere recuperati solo dal proprietario del video.
processingDetails.processingStatus string
Lo stato di elaborazione del video. Questo valore indica se YouTube ha potuto elaborare il video o se il video è ancora in fase di elaborazione.

I valori validi per questa proprietà sono:
  • failed - Elaborazione del video non riuscita. Vedi ProcessingFailureREASON.
  • processing: il video è in fase di elaborazione. Vedi Avanzamento di elaborazione.
  • succeeded - Il video è stato elaborato.
  • terminated - Le informazioni sull'elaborazione non sono più disponibili.
processingDetails.processingProgress object
L'oggetto processingProgress contiene informazioni sui progressi compiuti da YouTube nell'elaborazione del video. I valori sono davvero rilevanti solo se lo stato di elaborazione del video è processing.
processingDetails.processingProgress.partsTotal unsigned long
Una stima del numero totale di parti che devono essere elaborate per il video. Il numero potrebbe essere aggiornato con stime più precise mentre YouTube elabora il video.
processingDetails.processingProgress.partsProcessed unsigned long
Il numero di parti del video già elaborate da YouTube. Puoi stimare la percentuale di video già elaborata da YouTube calcolando:
100 * parts_processed / parts_total

Tieni presente che, poiché il numero stimato di parti potrebbe aumentare senza un aumento corrispondente del numero di parti già elaborate, è possibile che l'avanzamento calcolato possa diminuire periodicamente durante l'elaborazione di un video da parte di YouTube.
processingDetails.processingProgress.timeLeftMs unsigned long
Una stima del tempo, in millisecondi, necessario a YouTube per completare l'elaborazione del video.
processingDetails.processingFailureReason string
Il motivo per cui YouTube non è riuscito a elaborare il video. Questa proprietà avrà un valore solo se il valore della proprietà processingStatus è failed.

I valori validi per questa proprietà sono:
  • other - Un altro componente di elaborazione non è andato a buon fine.
  • streamingFailed: il video non può essere inviato agli autori dello streaming.
  • transcodeFailed - La transcodifica dei contenuti non è riuscita.
  • uploadFailed - La consegna del file non è riuscita.
processingDetails.fileDetailsAvailability string
Questo valore indica se i dettagli del file sono disponibili per il video caricato. Puoi recuperare i dettagli del file di un video richiedendo la parte fileDetails nella richiesta videos.list().
processingDetails.processingIssuesAvailability string
Questo valore indica se il motore di elaborazione video ha generato suggerimenti che potrebbero migliorare la capacità di YouTube di elaborare il video, avvisi che spiegano i problemi di elaborazione video o errori che li causano. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella richiesta videos.list().
processingDetails.tagSuggestionsAvailability string
Questo valore indica se i suggerimenti di parole chiave (tag) sono disponibili per il video. È possibile aggiungere tag ai metadati di un video per facilitare l'individuazione del video da parte di altri utenti. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella richiesta videos.list().
processingDetails.editorSuggestionsAvailability string
Questo valore indica se i suggerimenti di modifica del video, che potrebbero migliorare la qualità o l'esperienza di riproduzione, sono disponibili per il video. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella richiesta videos.list().
processingDetails.thumbnailsAvailability string
Questo valore indica se sono state generate immagini in miniatura per il video.
suggestions object
L'oggetto suggestions include suggerimenti che identificano le opportunità per migliorare la qualità del video o i metadati del video caricato. Questi dati possono essere recuperati solo dal proprietario del video.

L'oggetto suggestions verrà restituito solo se la proprietà processingDetails.tagSuggestionsAvailability o la proprietà processingDetails.editorSuggestionsAvailability ha un valore available.
suggestions.processingErrors[] list
Un elenco di errori che impediscono a YouTube di elaborare correttamente il video caricato. Questi errori indicano che, a prescindere dallo stato attuale di elaborazione del video, alla fine questo stato sarà quasi certamente failed.

I valori validi per questa proprietà sono:
  • archiveFile: un file di archivio (ad es. un archivio ZIP).
  • audioFile: il file contiene solo l'audio (ad es. un file MP3).
  • docFile: file di testo o documento (ad es. MS Word).
  • imageFile: file immagine (ad es. un'immagine JPEG).
  • notAVideoFile: altro file non video.
  • projectFile: file del progetto del film (ad es. Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Un elenco dei motivi per cui YouTube potrebbe riscontrare difficoltà nella transcodifica del video caricato o che potrebbero comportare una transcodifica errata. Questi avvisi vengono generati prima che YouTube elabori effettivamente il file video caricato. Inoltre, identificano i problemi che non indicano necessariamente che l'elaborazione del video non andrà a buon fine, ma che potrebbero comunque causare problemi come problemi di sincronizzazione, artefatti video o una traccia audio mancante.

I valori validi per questa proprietà sono:
  • hasEditlist: al momento, gli elenchi di modifica non sono supportati.
  • inconsistentResolution: risoluzioni di container e stream in conflitto.
  • problematicAudioCodec: è stato utilizzato il codec audio che è noto per causare problemi.
  • problematicVideoCodec: è stato utilizzato un codec video che è noto per causare problemi.
  • unknownAudioCodec: codec audio non riconosciuto, transcodifica potrebbe non riuscire.
  • unknownContainer: il formato del file non è riconosciuto, quindi è probabile che la transcodifica non vada a buon fine.
  • unknownVideoCodec: codec video non riconosciuto, transcodifica potrebbe non riuscire.
suggestions.processingHints[] list
Un elenco di suggerimenti che potrebbero migliorare la capacità di YouTube di elaborare il video.

I valori validi per questa proprietà sono:
  • nonStreamableMov: il file MP4 non può essere trasmesso in streaming, quindi l'elaborazione verrà rallentata.
  • sendBestQualityVideo - Probabilmente esiste una versione di qualità migliore del video.
suggestions.tagSuggestions[] list
Un elenco di tag delle parole chiave che potrebbero essere aggiunti ai metadati del video per aumentare le probabilità che gli utenti lo trovino quando effettuano ricerche o navigano su YouTube.
suggestions.tagSuggestions[].tag string
Il tag della parola chiave suggerito per il video.
suggestions.tagSuggestions[].categoryRestricts[] list
Un insieme di categorie di video per cui il tag è pertinente. Puoi utilizzare queste informazioni per visualizzare suggerimenti di tag appropriati in base alla categoria di video che l'utente che ha caricato il video associa al video. Per impostazione predefinita, i suggerimenti di tag sono pertinenti per tutte le categorie se per la parola chiave non sono state definite limitazioni.
suggestions.editorSuggestions[] list
Un elenco di operazioni di modifica dei video che potrebbero migliorare la qualità o l'esperienza di riproduzione del video caricato.

I valori validi per questa proprietà sono:
  • audioQuietAudioSwap - La traccia audio sembra silenziosa e potrebbe essere scambiata con una migliore qualità.
  • videoAutoLevels: i livelli di luminosità dell'immagine sembrano spenti e potrebbero essere corretti.
  • videoCrop: è possibile che i margini (opachi) rilevati intorno all'immagine vengano ritagliati.
  • videoStabilize: il video appare mosso e potrebbe essere stabilizzato.
liveStreamingDetails object
L'oggetto liveStreamingDetails contiene metadati relativi a una trasmissione video in diretta. L'oggetto sarà presente in una risorsa video solo se il video è una trasmissione dal vivo imminente, in diretta o completata.
liveStreamingDetails.actualStartTime datetime
L'ora in cui la trasmissione è iniziata. Il valore è specificato nel formato ISO 8601. Questo valore non sarà disponibile finché la trasmissione non inizierà.
liveStreamingDetails.actualEndTime datetime
L'ora in cui la trasmissione è terminata. Il valore è specificato nel formato ISO 8601. Questo valore non sarà disponibile finché la trasmissione non sarà terminata.
liveStreamingDetails.scheduledStartTime datetime
L'ora di inizio programmata della trasmissione. Il valore è specificato nel formato ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
L'ora di fine programmata per la trasmissione. Il valore è specificato nel formato ISO 8601. Se il valore è vuoto o la proprietà non è presente, la trasmissione pianificata è continua.
liveStreamingDetails.concurrentViewers unsigned long
Il numero di spettatori che stanno guardando la trasmissione. La proprietà e il suo valore saranno presenti se la trasmissione ha spettatori attuali e il proprietario non ha nascosto il numero di visualizzazioni del video. Tieni presente che YouTube smette di monitorare il numero di spettatori simultanei al termine della stessa. Pertanto, questa proprietà non identificherebbe il numero di spettatori che guardano un video archiviato di una trasmissione in diretta già terminata.
liveStreamingDetails.activeLiveChatId string
L'ID della chat dal vivo attualmente attiva associata a questo video. Questo campo viene compilato solo se il video è una trasmissione dal vivo che include chat dal vivo. Una volta completata la transizione della trasmissione per completare questo campo, la chat dal vivo verrà chiusa. Per le trasmissioni permanenti, l'ID della chat dal vivo non sarà più associato a questo video, ma al nuovo video mostrato nella pagina permanente.
localizations object
L'oggetto localizations contiene traduzioni dei metadati del video.
localizations.(key) object
La lingua del testo localizzato associato alla coppia chiave-valore. Il valore è una stringa che contiene un codice lingua BCP-47.
localizations.(key).title string
Il titolo del video localizzato.
localizations.(key).description string
La descrizione del video localizzata.