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 sottoporsi a un controllo per verificare la conformità ai Termini di servizio. Per ulteriori dettagli, consulta la Cronologia delle revisioni dell'API.

Una risorsa video rappresenta un video di YouTube.

Metodi

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

getRating

Recupero delle valutazioni assegnate dall'utente autorizzato a un elenco di video specificati. Prova subito.

list

Restituisce un elenco di video corrispondenti ai parametri di richiesta dell'API. Prova subito.

insert

Carica un video su YouTube e, facoltativamente, imposta i metadati del video.

update

Aggiorna i metadati di un video. Prova subito.

elimina

Elimina un video di YouTube. Prova subito.

rate

Aggiungere una valutazione di Mi piace o Non mi piace a un video o rimuoverla. Prova subito.

reportAbuse

Segnalare un video per contenuti offensivi. 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,
    "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
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Proprietà

La tabella seguente definisce le proprietà 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 i dettagli di base del video, come titolo, descrizione e categoria.
snippet.publishedAt	datetime La data e l'ora di pubblicazione del video. Tieni presente che questa data potrebbe essere diversa da quella in cui è stato caricato il video. Ad esempio, se un video viene caricato come privato e poi reso pubblico in un secondo momento, questa proprietà specifica il momento in cui il video è stato reso pubblico. Esistono un paio di casi speciali: Se un video viene caricato come privato e i metadati del video vengono recuperati dal proprietario del canale, il valore della proprietà specifica la data e l'ora del caricamento del video. Se un video viene caricato come non in elenco, il valore della proprietà specifica anche la data e l'ora del caricamento. In questo caso, chiunque conosca l'ID video univoco 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, ad eccezione di < 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, ad eccezione di < e >.
snippet.thumbnails	object Una mappa delle immagini in miniatura 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 I valori chiave validi sono: default: l'immagine in miniatura predefinita. La miniatura predefinita di un video o di una risorsa che rimanda a un video, ad esempio un elemento di 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 dell'immagine in miniatura con una risoluzione più elevata. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 320 pixel e un'altezza di 180 pixel. Per un canale, l'immagine deve avere una larghezza di 240 pixel e un'altezza di 240 pixel. high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 480 px e un'altezza di 360 px. Per un canale, l'immagine deve avere una larghezza di 800 px e un'altezza di 800 px. standard: una versione dell'immagine in miniatura con una risoluzione ancora superiore rispetto all'immagine con risoluzione high. Questa immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi delle playlist o i risultati di ricerca. Questa immagine è larga 640 px e alta 480 px. maxres: la versione con la risoluzione più alta dell'immagine in miniatura. Questa dimensione dell'immagine è disponibile per alcuni video e altre risorse che fanno riferimento ai video, come gli elementi delle playlist o i risultati di ricerca. Questa immagine è larga 1280 pixel e alta 720 pixel.
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 Il titolo del canale a cui appartiene il video.
snippet.tags[]	list Un elenco di tag delle 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 dell'elenco vengono conteggiate ai fini del 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 ai fini del limite di caratteri. Pertanto, ai fini dei limiti di caratteri, il tag Foo-Baz contiene sette caratteri, mentre il tag Foo Baz ne contiene nove.
snippet.categoryId	string La categoria del 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 imminente/attiva. In alternativa, è "none" se il video non è una trasmissione in diretta imminente/attiva. 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 e una descrizione localizzati per il video oppure il titolo nella lingua predefinita per i metadati del video. Il testo localizzato viene restituito nello snippet della 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 è specificato un valore del parametro hl o se è specificato un valore, ma i metadati localizzati non sono disponibili per la lingua specificata. La proprietà contiene un valore di sola lettura. Utilizza l'oggetto localizations per aggiungere, aggiornare o eliminare i 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 del video, inclusa la durata e un'indicazione se i sottotitoli codificati sono disponibili per il video.
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 si riferiscono alla durata in minuti e secondi, rispettivamente. 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 pari a 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 il # che precede la lettera H specifica la durata del video in ore e tutti gli altri dettagli sono gli stessi descritti sopra. Se il video dura almeno un giorno, le lettere P e T sono separate e il formato del valore è P#DT#H#M#S. Per informazioni dettagliate, consulta la specifica ISO 8601.
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 codificati sono disponibili per il video. I valori validi per questa proprietà sono: false true
contentDetails.licensedContent	boolean Indica se il video rappresenta contenuti in licenza, ovvero contenuti che sono stati caricati su un canale collegato a un partner per i contenuti di YouTube e poi rivendicati da questo partner.
contentDetails.regionRestriction	object L'oggetto regionRestriction contiene informazioni sui paesi in cui un video è (o non è) visibile. 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, la visualizzazione del video in quel paese viene bloccata. Se questa proprietà è presente e contiene un elenco vuoto, il video viene 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 relativo valore, il video è visibile in quel 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 sistemi di classificazione.
contentDetails.contentRating.acbRating	string La classificazione del video assegnata dall'Australian Classification Board (ACB) o dall'Australian Communications and Media Authority (ACMA). Le classificazioni ACMA vengono utilizzate per classificare la programmazione televisiva per bambini. I valori validi per questa proprietà sono: acbC: programmi classificati come C dall'Australian Communications and Media Authority. Questi programmi sono destinati ai bambini (che non siano in età prescolare) al di sotto di 14 anni. acbE – E acbG – G acbM – M acbMa15plus – MA15+ acbP: programmi classificati come P dall'Australian Communications and Media Authority. Questi programmi sono destinati a bambini in età prescolare. acbPg – PG acbR18plus – R18+ acbUnrated
contentDetails.contentRating.agcomRating	string La classificazione del video da parte 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 classificazione 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 classificazione del British Board of Film Classification (BBFC) del video. I valori validi per questa proprietà sono: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string La classificazione del video da parte del 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 classificazione del video assegnata dalla Commissione austriaca per la classificazione dei media (Bundesministerium für Unterricht, Kunst und Kultur). I valori validi per questa proprietà sono: bmukk10 – 10+ bmukk12 – 12+ bmukk14 – 14 anni e più bmukk16 – 16 anni o più bmukk6 – 6+ bmukk8 – 8+ bmukkAa – Senza restrizioni bmukkUnrated
contentDetails.contentRating.catvRating	string Sistema di classificazione per la TV canadese - Canadian TV Classification System La classificazione del video della Canadian Radio-Television and Telecommunications Commission (CRTC) per le trasmissioni in lingua inglese in Canada. Per ulteriori informazioni, visita il sito web del Canadian Broadcast Standards Council. I valori validi per questa proprietà sono: catv14plus – 14 anni e più catv18plus – 18 anni o più catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string La classificazione del video della Canadian Radio-Television and Telecommunications Commission (CRTC) per le trasmissioni in lingua francese in Canada. Per ulteriori informazioni, visita il sito web del Canadian Broadcast Standards Council. I valori validi per questa proprietà sono: catvfr13plus – 13+ catvfr16plus – 16 anni o più catvfr18plus – 18 anni o più catvfr8plus – 8+ catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string La classificazione del video assegnata dal 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 La classificazione del Consejo de Calificación Cinematográfica (Cile) del video. I valori validi per questa proprietà sono: ccc14 – 14 anni e più ccc18 – 18 anni o più ccc18s – 18+ - 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 classificazione del video della Commissione 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 classificazione 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 classificazione del video secondo il Canadian Home Video Rating System (CHVRS). I valori validi per questa proprietà sono: chvrs14a – 14A chvrs18a – 18A chvrsE – E chvrsG – G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.cicfRating	string La classificazione 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 classificazione del video assegnata dal CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) della Romania. I valori validi per questa proprietà sono: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – 18 anni o più cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Sistema di classificazione in Francia - Commission de classification cinématographique 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 classificazione del video assegnata dal Conseil supérieur de l'audiovisuel francese, che classifica 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 classificazione del video della Commission de surveillance de la classification des films (CSCF) del 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 La classificazione del video in Repubblica Ceca. I valori validi per questa proprietà sono: czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string La classificazione del video assegnata dal Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasile). I valori validi per questa proprietà sono: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Motivi che spiegano perché il video ha ricevuto la classificazione DJCQT (Brasile).
contentDetails.contentRating.ecbmctRating	string Sistema di classificazione in Turchia - Commissione di valutazione e classificazione del Ministero della cultura e del turismo I valori validi per questa proprietà sono: ecbmct13a – 13A ecbmct13plus – 13+ ecbmct15a – 15A ecbmct15plus – 15+ ecbmct18plus – 18 anni o più ecbmct7a – 7A ecbmct7plus – 7+ ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6+ ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus – 16 anni o più
contentDetails.contentRating.eefilmRating	string La classificazione del video in Estonia. I valori validi per questa proprietà sono: eefilmK12 – Istruzione primaria e secondaria eefilmK14 – Istruzione primaria e secondaria eefilmK16 – K-16 eefilmK6 – K-6 eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string La 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 Eirin (映倫) del video. Eirin è il sistema di classificazione giapponese. I valori validi per questa proprietà sono: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string La classificazione del video assegnata dalla Film Censorship Board della Malaysia. I valori validi per questa proprietà sono: 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 classificazione del video dell'Office for Film, Newspaper and Article Administration 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. Utilizza la proprietà contentDetails.contentRating.cncRating. La classificazione del video del Centre national du cinéma et de l'image animé (Ministero della cultura francese). 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 classificazione del video assegnata dalla Film and Publication Board del Sudafrica. I valori validi per questa proprietà sono: fpb10 – 10 fpb1012Pg – 10-12PG fpb13 – 13 fpb16 – 16 fpb18 – 18 fpb79Pg - 7-9-PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Motivi che spiegano perché il video ha ricevuto la classificazione dell'FPB (Sudafrica).
contentDetails.contentRating.fskRating	string La classificazione Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germania) del video. I valori validi per questa proprietà sono: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string La classificazione del video in Grecia. I valori validi per questa proprietà sono: grfilmE – E grfilmK - K grfilmK12 – Istruzione primaria e secondaria grfilmK13 – K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string La classificazione del video assegnata dall'Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA, Spagna). 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 da parte dell'Irish Film Classification Office (IFCO - Irlanda). Per ulteriori informazioni, visita il sito web di IFCO. I valori validi per questa proprietà sono: ifco12 – 12 ifco12a – 12A ifco15 – 15 ifco15a – 15A ifco16 – 16 ifco18 – 18 ifcoG – G ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string La classificazione del video in Israele. I valori validi per questa proprietà sono: ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string La classificazione del video da parte dell'INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina). 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 classificazione del video assegnata dalla 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 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 kijkwijzerAl – AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string La classificazione del video da parte della Korea Media Rating Board (영상물등급위원회). La KMRB classifica i video in Corea del Sud. I valori validi per questa proprietà sono: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string La classificazione del video da parte del Lembaga Sensor Film dell'Indonesia. I valori validi per questa proprietà sono: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string La classificazione del video assegnata dal Film Age-Classification Board di Malta. I valori validi per questa proprietà sono: mccaa12 – 12 mccaa12a – 12A mccaa14 – 14 - questa classificazione è stata rimossa dalla nuova struttura di classificazione introdotta nel 2013. mccaa15 – 15 mccaa16 – 16 - questa classificazione è stata rimossa dalla nuova struttura di classificazione introdotta nel 2013. mccaa18 – 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string La classificazione del video del Media Council for Children and Young People del Danish Film Institute (Det Danske Filminstitut). I valori validi per questa proprietà sono: mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A mccypUnrated
contentDetails.contentRating.mcstRating	string Il sistema di classificazione del video per il Vietnam - MCST I valori validi per questa proprietà sono: mcst0 – 0 mcst16plus – 16 anni o più mcstC13 – C13 mcstC16 – C16 mcstC18 – C18 mcstP – P mcstUnrated mcstT13 – T13 mcstT16 – T16 mcstT18 – T18 mcstK - K
contentDetails.contentRating.mdaRating	string La classificazione del video assegnata dalla Media Development Authority (MDA) di Singapore e, in particolare, dal Board of Film Censors (BFC). I valori validi per questa proprietà sono: mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG13 mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string La classificazione del video da parte di Medietilsynet, l'autorità norvegese per i media. 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 classificazione del video assegnata dall'istituto finlandese Kansallinen Audiovisuaalinen Instituutti (Istituto nazionale audiovisivo). I valori validi per questa proprietà sono: meku12 – 12 meku16 – 16 meku18 – 18 meku7 – 7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string La classificazione del video del Ministero dei Beni e delle Attività Culturali e del Turismo (Italia). I valori validi per questa proprietà sono: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string La classificazione del video del Ministero della Cultura (Colombia). I valori validi per questa proprietà sono: moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned – Bannato mocE – E mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string La classificazione 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 classificazione della Motion Picture Association of America per i trailer e le anteprime dei film. I valori validi per questa proprietà sono: mpaatGb – GB (fascia verde: approvato per tutti i segmenti di pubblico) mpaatRb – RB (fascia rossa, consigliata per i maggiori di 17 anni)
contentDetails.contentRating.mtrcbRating	string La classificazione del video assegnata dalla Movie 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 classificazione del video dell'Ufficio nazionale di classificazione delle Maldive. I valori validi per questa proprietà sono: nbc12plus – 12+ nbc15plus – 15+ nbc18plus – 18 anni o più nbc18plusr – 18+R nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string La classificazione del video assegnata dal Centro nazionale cinematografico bulgaro. I valori validi per questa proprietà sono: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX – X
contentDetails.contentRating.nfvcbRating	string La classificazione del video assegnata dalla National Film and Video Censors Board della Nigeria. I valori validi per questa proprietà sono: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string La classificazione del video assegnata dal Nacionãlais Kino centrs (Centro nazionale del cinema della Lettonia). I valori validi per questa proprietà sono: nkclv12plus – 12+ nkclv18plus – 18 anni o più nkclv7plus – 7+ nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string La classificazione del video dell'Office of Film and Literature Classification (OFLC, Nuova Zelanda). I valori validi per questa proprietà sono: oflcG – G oflcM – M oflcPg – PG oflcR13 – R13 oflcR15 – R15 oflcR16 – R16 oflcR18 – R18 oflcRp13 – RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string La classificazione 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 classificazione 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 classificazione 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 classificazione del video da parte della Raidió Teilifís Éireann irlandese. I valori validi per questa proprietà sono: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string La classificazione del National Film Registry della Federazione Russa (MKRF - Russia) del video. I valori validi per questa proprietà sono: russia0 – 0+ russia12 – 12+ russia16 – 16 anni o più russia18 – 18 anni o più russia6 – 6+ russiaUnrated
contentDetails.contentRating.skfilmRating	string La classificazione 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 classificazione 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 classificazione del video da parte di Statens medieråd (Consiglio nazionale per i media della Svezia). I valori validi per questa proprietà sono: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Tutte le età smsaUnrated
contentDetails.contentRating.tvpgRating	string La classificazione TV Parental Guidelines (TVPG) del video. 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 con 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 un'immagine della miniatura personalizzata per il video. Questa proprietà è visibile solo all'utente che ha caricato il video.
status	object L'oggetto status contiene informazioni sullo stato 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 il caricamento di un video non è riuscito. 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 il motivo per cui 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 programmate per la pubblicazione del video. Può essere impostato solo se lo stato della privacy del video è privato. Il valore è specificato nel formato ISO 8601. Tieni presente i seguenti due punti aggiuntivi sul comportamento di questa proprietà: Se imposti il valore di questa proprietà quando chiami il metodo videos.update, devi impostare anche il valore della proprietà status.privacyStatus su private anche se il video è già privato. Se la tua richiesta prevede la pubblicazione di un video in un momento passato, il video verrà pubblicato immediatamente. Di conseguenza, l'effetto dell'impostazione della proprietà status.publishAt su una data e un'ora passate è lo stesso della modifica del valore 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 pubblicamente. Per impostazione predefinita, queste statistiche sono visibili e, ad esempio, il numero di visualizzazioni e le valutazioni di un video continueranno a essere visibili pubblicamente anche se il valore di questa proprietà è impostato su false.
status.madeForKids	boolean Questo valore indica se il video è destinato ai bambini e contiene lo stato corrente "Destinato ai bambini" del video. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Per ulteriori informazioni sull'impostazione del pubblico per il tuo canale, i tuoi video o le tue trasmissioni, consulta il Centro assistenza YouTube.
status.selfDeclaredMadeForKids	boolean In una richiesta videos.insert o videos.update, questa proprietà consente al proprietario del canale di indicare che il video è 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.
status.containsSyntheticMedia	boolean In una richiesta videos.insert o videos.update, questa proprietà consente al proprietario del canale di dichiarare che un video include contenuti sintetici o alterati (A/S) realistici. Scopri di più sulle norme di YouTube relative ai contenuti di annunci di servizi. Alcuni esempi di contenuti di tipo A/S sono i video che: Far sembrare che una persona reale stia dicendo o facendo qualcosa che in realtà non ha detto o fatto Alterare il filmato di un evento o un luogo reale Genera una scena realistica che non è realmente avvenuta
statistics	object L'oggetto statistics contiene le statistiche sul video.
statistics.viewCount	unsigned long Il numero di volte in cui il video è stato visualizzato. A partire dal 31 marzo 2025, per gli Short, la metrica viewCount restituirà il numero di volte in cui uno Short viene riprodotto o rivisto, senza alcun requisito di tempo di visualizzazione minimo.
statistics.likeCount	unsigned long Il numero di utenti che hanno indicato di aver apprezzato il video.
statistics.dislikeCount	unsigned long Nota: la proprietà statistics.dislikeCount è stata impostata come privata dal 13 dicembre 2021. Ciò significa che la proprietà viene inclusa in una risposta dell'API solo se la richiesta dell'API è stata autenticata dal proprietario del video. Per ulteriori informazioni, consulta la cronologia delle revisioni. Il numero di utenti che hanno indicato di non aver apprezzato il video.
statistics.favoriteCount	unsigned long Nota: questa proprietà è stata ritirata. Il ritiro è in vigore dal 28 agosto 2015. Il valore della proprietà è ora sempre impostato su 0.
statistics.commentCount	unsigned long Il numero di commenti relativi al video.
paidProductPlacementDetails	object L'oggetto paidProductPlacementDetails contiene informazioni sul posizionamento di prodotti a pagamento nel video.
paidProductPlacementDetails.hasPaidProductPlacement	boolean Imposta su true se i contenuti utilizzano il posizionamento di prodotti a pagamento. Il valore predefinito è false.
player	object L'oggetto player contiene le informazioni che utilizzerai 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 dell'API per recuperare la risorsa specifica un valore per i parametri maxHeight e/o maxWidth, le dimensioni del player incorporato vengono ridimensionate per soddisfare i requisiti di maxHeight e/o maxWidth. Se le proporzioni del video sono sconosciute, il player incorporato utilizza per impostazione predefinita un formato 4:3.
player.embedHeight	long L'altezza del player incorporato restituito nella proprietà player.embedHtml. Questa proprietà viene restituita solo se la richiesta ha specificato un valore per i parametri maxHeight e/o maxWidth e se è noto il formato del video.
player.embedWidth	long La larghezza del player incorporato restituito nella proprietà player.embedHtml. Questa proprietà viene restituita solo se la richiesta ha specificato un valore per i parametri maxHeight e/o maxWidth e se è noto il formato del video.
topicDetails	object L'oggetto topicDetails racchiude le informazioni sugli argomenti associati al video. Importante: consulta le definizioni delle proprietà topicDetails.relevantTopicIds[] e topicDetails.topicIds[], nonché la cronologia delle revisioni per ulteriori dettagli sulle modifiche imminenti relative agli ID argomento.
topicDetails.topicIds[]	list Importante: questa proprietà è stata ritirata a partire dal 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 a partire dal 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 momento, YouTube ha iniziato a restituire un piccolo insieme di ID argomento selezionati. Visualizza gli ID argomento supportati a partire dal 15 febbraio 2017 Argomenti Argomenti musicali /m/04rlf Musica (argomento principale) /m/02mscn musica cristiana /m/0ggq0m Musica classica /m/01lyv Paese /m/02lkt Musica elettronica /m/0glt670 Musica hip hop /m/05rwpb Musica indipendente /m/03_d0 Jazz /m/028sqc Musica dell'Asia /m/0g293 Musica latinoamericana /m/064t9 Musica pop /m/06cqb Reggae /m/06j6l Rhythm e Blues /m/06by7 Musica rock /m/0gywn Musica soul Argomenti relativi ai giochi /m/0bzvm2 Giochi (argomento principale) /m/025zzc Gioco d'azione /m/02ntfj Gioco di avventura e azione /m/0b1vjn Casual game /m/02hygl Videogioco musicale /m/04q1x3q Videogioco rompicapo /m/01sjng Videogioco di corse /m/0403l3g Videogioco di ruolo /m/021bp2 Videogioco di simulazione /m/022dc6 Gioco sportivo /m/03hf_rm Videogioco di strategia Argomenti sportivi /m/06ntj Sport (argomento principale) /m/0jm_ Football americano /m/018jz Baseball /m/018w8 Pallacanestro /m/01cgz Pugilato /m/09xp_ Cricket /m/02vx4 Calcio /m/037hz Golf /m/03tmr Hockey su ghiaccio /m/01h7lh Arti marziali miste /m/0410tth Sport motoristici /m/07bs0 Tennis /m/07_53 Pallavolo Argomenti di intrattenimento /m/02jjt Intrattenimento (argomento principale) /m/09kqc Umorismo /m/02vxn Film /m/05qjc Arti performative /m/066wd Wrestling professionistico /m/0f2f9 Programmi TV Argomenti di stile di vita /m/019_rr Stile di vita (argomento principale) /m/032tl Moda /m/027x7n Fitness /m/02wbm Cibo /m/03glg Hobby /m/068hy Animali domestici /m/041xxh Attrattiva fisica [Bellezza] /m/07c1v Tecnologia /m/07bxq Turismo /m/07yv9 Veicoli Argomenti sociali /m/098wr Società (argomento principale) /m/09s1f Attività commerciale /m/0kt51 Salute /m/01h6rj Forze armate /m/05qt0 Politica /m/06bvp Religione Altri argomenti /m/01k8wb Conoscenza
topicDetails.topicCategories[]	list Un elenco di URL di Wikipedia che forniscono una descrizione generale dei contenuti del video.
recordingDetails	object L'oggetto recordingDetails racchiude informazioni sulla località, sulla data e sull'indirizzo in cui è stato registrato il video.
recordingDetails.locationDescription	string Questa proprietà è stata ritirata a partire dal 1° giugno 2017. Per ulteriori dettagli, consulta l'annuncio sul ritiro. La descrizione testuale della località in cui è stato registrato il video.
recordingDetails.location	object Le informazioni sulla geolocalizzazione associate al video. Tieni presente che i valori delle proprietà secondarie identificano la località che il proprietario del video vuole associare al video. Il valore è modificabile, disponibile per la ricerca nei video pubblici e potrebbe essere mostrato agli utenti per i video pubblici.
recordingDetails.location.latitude	double Questa proprietà è stata ritirata a partire dal 1° giugno 2017. Per ulteriori dettagli, consulta l'annuncio sul ritiro. Latitudine in gradi.
recordingDetails.location.longitude	double Questa proprietà è stata ritirata a partire dal 1° giugno 2017. Per ulteriori dettagli, consulta l'annuncio sul ritiro. Longitudine in gradi.
recordingDetails.location.altitude	double Questa proprietà è stata ritirata il 9 luglio 2018. Per ulteriori dettagli, consulta l'annuncio sul 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 racchiude le informazioni sul file video caricato su YouTube, tra cui la risoluzione, la durata, i codec audio e video, le frequenze in bit dello stream e altro ancora. Questi dati possono essere recuperati solo dal proprietario del video. L'oggetto fileDetails viene restituito solo se la proprietà processingDetails.fileAvailability ha un valore available.
fileDetails.fileName	string Il nome del file caricato. Questo campo è presente indipendentemente dal fatto che sia stato caricato un file video o di altro tipo.
fileDetails.fileSize	unsigned long Le dimensioni del file caricato in byte. Questo campo è presente indipendentemente dal fatto che sia stato caricato un file video o di altro tipo.
fileDetails.fileType	string Il tipo di file caricato rilevato dal motore di elaborazione video di YouTube. Al momento, YouTube elabora solo i file video, ma questo campo è presente indipendentemente dal fatto che sia 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 documento di MS Word. image: il file è un file immagine, ad esempio un'immagine .jpeg. other: il file è di un altro tipo di file non video. project: il file è un file di 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 stream video contenuti nel file video caricato. Ogni elemento dell'elenco contiene metadati dettagliati su uno stream video.
fileDetails.videoStreams[].widthPixels	unsigned integer La larghezza dei contenuti video codificati in pixel. Puoi calcolare le proporzioni di codifica del video come width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels	unsigned integer L'altezza in pixel dei contenuti video codificati.
fileDetails.videoStreams[].frameRateFps	double La frequenza fotogrammi dello stream video, 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 dello stream video, in bit al secondo.
fileDetails.videoStreams[].rotation	string L'angolo di rotazione necessario 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 un altro 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. In genere, il valore è un codice fornitore di quattro lettere.
fileDetails.audioStreams[]	list Un elenco di stream audio contenuti nel file video caricato. Ogni elemento dell'elenco contiene metadati dettagliati su 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. In genere, il valore è un codice fornitore di quattro lettere.
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 in bit 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. Al momento sono supportati i seguenti formati ISO 8601: Solo data: YYYY-MM-DD Ora naive: YYYY-MM-DDTHH:MM:SS Ora con fuso orario: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object L'oggetto processingDetails racchiude le informazioni sull'avanzamento di YouTube nell'elaborazione del file video caricato. Le proprietà nell'oggetto identificano lo stato corrente dell'elaborazione e una stima del tempo rimanente prima che YouTube termini l'elaborazione del video. Questa parte indica anche se per il video sono disponibili diversi tipi di dati o contenuti, come i dettagli del file o le immagini in miniatura. L'oggetto processingProgress è progettato per essere sottoposto a polling in modo che il video caricato possa monitorare l'avanzamento dell'elaborazione del file video caricato da YouTube. Questi dati possono essere recuperati solo dal proprietario del video.
processingDetails.processingStatus	string Lo stato di elaborazione del video. Questo valore indica se YouTube è stato in grado di elaborare il video o se l'elaborazione è ancora in corso. I valori validi per questa proprietà sono: failed – Elaborazione video non riuscita. Vedi ProcessingFailureReason. processing: il video è in fase di elaborazione. Vedi ProcessingProgress. succeeded: il video è stato elaborato correttamente. terminated: le informazioni sull'elaborazione non sono più disponibili.
processingDetails.processingProgress	object L'oggetto processingProgress contiene informazioni sull'avanzamento dell'elaborazione del video da parte di YouTube. I valori sono pertinenti solo se lo stato di elaborazione del video è processing.
processingDetails.processingProgress.partsTotal	unsigned long Una stima del numero totale di parti da elaborare per il video. Il numero potrebbe essere aggiornato con stime più precise durante l'elaborazione del video da parte di YouTube.
processingDetails.processingProgress.partsProcessed	unsigned long Il numero di parti del video già elaborate da YouTube. Puoi stimare la percentuale del 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 – Impossibile inviare il video ai live streamer. transcodeFailed – Transcodifica dei contenuti non riuscita. uploadFailed – Caricamento del file non riuscito.
processingDetails.fileDetailsAvailability	string Questo valore indica se sono disponibili i dettagli del file 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 dei video ha generato suggerimenti che potrebbero migliorare la capacità di YouTube di elaborare il video, avvisi che spiegano i problemi di elaborazione del video o errori che causano problemi di elaborazione del video. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella richiesta videos.list().
processingDetails.tagSuggestionsAvailability	string Questo valore indica se sono disponibili suggerimenti per le parole chiave (tag) per il video. I tag possono essere aggiunti ai metadati di un video per facilitarne la ricerca da parte di altri utenti. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella richiesta videos.list().
processingDetails.editorSuggestionsAvailability	string Questo valore indica se sono disponibili suggerimenti per l'editing dei video, che potrebbero migliorare la qualità del video o l'esperienza di riproduzione. 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 racchiude suggerimenti che identificano 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 viene 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, indipendentemente dall'attuale stato di elaborazione del video, questo stato sarà quasi certamente failed. I valori validi per questa proprietà sono: archiveFile: un file archivio (ad es. un archivio ZIP). audioFile: il file contiene solo audio (ad es. un file MP3). docFile – File di documenti o di testo (ad es. Documento MS Word). imageFile - File immagine (ad es. un'immagine JPEG). notAVideoFile: altro file non video. projectFile - File di progetto di Movie (ad es. Progetto Microsoft Windows Movie Maker).
suggestions.processingWarnings[]	list Un elenco di motivi per cui YouTube potrebbe avere difficoltà a transcodificare il video caricato o che potrebbero comportare una transcodifica errata. Questi avvisi vengono generati prima che YouTube elabori effettivamente il file video caricato. Inoltre, identificano 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 non è possibile modificare gli elenchi. inconsistentResolution - Risoluzioni del contenitore e dello stream in conflitto. problematicAudioCodec: è stato utilizzato un codec audio noto per causare problemi. problematicVideoCodec: è stato utilizzato un codec video noto per causare problemi. unknownAudioCodec – Codec audio non riconosciuto, la transcodifica potrebbe non riuscire. unknownContainer – Formato file non riconosciuto, la transcodifica potrebbe non riuscire. unknownVideoCodec – Codec video non riconosciuto, è probabile che la transcodifica non vada a buon fine.
suggestions.processingHints[]	list Un elenco di suggerimenti che possono migliorare la capacità di YouTube di elaborare il video. I valori validi per questa proprietà sono: nonStreamableMov: il file MP4 non è riproducibile in streaming, il che rallenta l'elaborazione. sendBestQualityVideo: probabilmente esiste una versione del video di qualità migliore.
suggestions.tagSuggestions[]	list Un elenco di tag di parole chiave che possono 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 le quali il tag è pertinente. Puoi utilizzare queste informazioni per mostrare suggerimenti di tag appropriati in base alla categoria del video associata dall'utente che lo ha caricato. Per impostazione predefinita, i suggerimenti di tag sono pertinenti per tutte le categorie se non sono state definite limitazioni per la parola chiave.
suggestions.editorSuggestions[]	list Un elenco di operazioni di editing 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 non avere audio e potrebbe essere sostituita con una di qualità migliore. videoAutoLevels: i livelli di luminosità delle immagini sembrano non essere corretti e potrebbero essere corretti. videoCrop: i bordi (matte) rilevati intorno all'immagine potrebbero essere ritagliati. videoStabilize: il video sembra tremolare e potrebbe essere stabilizzato.
liveStreamingDetails	object L'oggetto liveStreamingDetails contiene i metadati di una trasmissione video in diretta. L'oggetto sarà presente in una risorsa video solo se il video è una trasmissione in diretta imminente, in diretta o completata.
liveStreamingDetails.actualStartTime	datetime L'ora effettiva di inizio della trasmissione. Il valore è specificato nel formato ISO 8601. Questo valore non sarà disponibile fino all'inizio della trasmissione.
liveStreamingDetails.actualEndTime	datetime L'ora in cui è terminata effettivamente la trasmissione. Il valore è specificato nel formato ISO 8601. Questo valore non sarà disponibile fino al termine della trasmissione.
liveStreamingDetails.scheduledStartTime	datetime L'ora pianificata per l'inizio della trasmissione. Il valore è specificato nel formato ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime L'ora programmata per la fine della trasmissione. Il valore è specificato nel formato ISO 8601. Se il valore è vuoto o la proprietà non è presente, la trasmissione è programmata per continuare a tempo indeterminato.
liveStreamingDetails.concurrentViewers	unsigned long Il numero di spettatori che stanno attualmente guardando la trasmissione. La proprietà e il relativo valore saranno presenti se la trasmissione ha spettatori attuali e il proprietario della trasmissione non ha nascosto il conteggio delle visualizzazioni del video. Tieni presente che YouTube smette di monitorare il numero di spettatori simultanei di una trasmissione al termine della stessa. Pertanto, questa proprietà non identifica il numero di spettatori che guardano un video archiviato di una trasmissione in diretta già terminata. Il numero di spettatori simultanei restituito dall'API di dati di YouTube potrebbe essere diverso da quello elaborato e privato di spam disponibile tramite YouTube Analytics. Scopri di più sulle metriche dei live streaming nel Centro assistenza YouTube.
liveStreamingDetails.activeLiveChatId	string L'ID della chat live attualmente attiva associata a questo video. Questo campo viene compilato solo se il video è una trasmissione in diretta con chat live. Una volta completata la transizione della trasmissione, questo campo verrà rimosso e la chat live verrà chiusa. Per le trasmissioni permanenti, l'ID chat live non sarà più associato a questo video, ma al nuovo video visualizzato nella pagina permanente.
localizations	object L'oggetto localizations contiene le traduzioni dei metadati del video.
localizations.(key)	object La lingua del testo localizzato associato al valore della chiave. Il valore è una stringa contenente un codice lingua BCP-47.
localizations.(key).title	string Il titolo del video localizzato.
localizations.(key).description	string La descrizione del video localizzata.