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. Per ulteriori dettagli, consulta la Cronologia delle revisioni delle 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 [aliquota]
- 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 della risorsa
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 in cui il video è stato pubblicato. Tieni presente che questo intervallo di tempo potrebbe essere diverso da quello 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:
|
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 della mappa, la chiave è il nome dell'immagine in miniatura, mentre il valore è un oggetto che contiene altre informazioni sulla miniatura. |
snippet.thumbnails.(key) |
object I valori chiave validi sono:
|
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 basati su 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 per il calcolo del limite di caratteri:
|
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:
|
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.
localizations per aggiungere, aggiornare o eliminare i titoli localizzati. |
snippet.localized.title |
string Il titolo localizzato del video. |
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, mentre le lettere M e S si riferiscono alla durata rispettivamente 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 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 di quelli 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:
|
contentDetails.caption |
string Indica se i sottotitoli codificati sono disponibili per il video. I valori validi per questa proprietà sono:
|
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 quel 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, significa che 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:
|
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:
|
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:
|
contentDetails.contentRating.bbfcRating |
string La classificazione BBFC (British Board of Film Classification) del video. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.bmukkRating |
string La classificazione del video rilasciata dall'Austria Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur). I valori validi per questa proprietà sono:
|
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:
|
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:
|
contentDetails.contentRating.cbfcRating |
string La classificazione del video assegnata dal Central Board of Film Certification (CBFC, India). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.cccRating |
string La classificazione del Consejo de Calificación Cinematográfica (Cile) del video. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.chfilmRating |
string La classificazione del video in Svizzera. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.chvrsRating |
string La classificazione del video secondo il Canadian Home Video Rating System (CHVRS). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.cicfRating |
string La classificazione del video della Commission de Contrôle des Films (Belgio). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.cnaRating |
string La classificazione del video assegnata dal CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) della Romania. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.cncRating |
string Sistema di classificazione in Francia - Commission deClassification cinematographique I valori validi per questa proprietà sono:
|
contentDetails.contentRating.csaRating |
string La classificazione del video assegnata dal Conseil supérieur de l'audiovisuel francese, che assegna una classificazione ai contenuti trasmessi. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.cscfRating |
string La classificazione del video rilasciata dalla Commissione de sorveglianza della classificazione dei film (CSCF) del Lussemburgo. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.czfilmRating |
string La classificazione del video nella Repubblica Ceca. I valori validi per questa proprietà sono:
|
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:
|
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:
|
contentDetails.contentRating.eefilmRating |
string La valutazione del video in Estonia. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.egfilmRating |
string La classificazione del video in Egitto. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.eirinRating |
string La valutazione Eirin (映倫) del video. Eirin è il sistema di classificazione giapponese. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.fcbmRating |
string La classificazione del video assegnata dalla Film Censorship Board della Malaysia. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.fcoRating |
string La classificazione del video rilasciata dall'Office for Film, Newspaper and Article Administration di Hong Kong. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.fpbRating |
string La classificazione del video assegnata dalla Film and Publication Board del Sudafrica. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Motivi che spiegano perché il video ha ricevuto la classificazione FPB (Sudafrica). |
contentDetails.contentRating.fskRating |
string La classificazione Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germania) del video. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.grfilmRating |
string La valutazione del video in Grecia. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.ifcoRating |
string La classificazione del video assegnata dall'Irish Film Classification Office (IFCO - Irlanda). Per ulteriori informazioni, visita il sito web di IFCO. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.ilfilmRating |
string La classificazione del video in Israele. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.kfcbRating |
string La classificazione del video assegnata dalla Kenya Film Classification Board. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Paesi Bassi). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.kmrbRating |
string La valutazione del video in Corea (영상물등선선무선) La KMRB classifica i video in Corea del Sud. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.lsfRating |
string La classificazione del video da parte del Lembaga Sensor Film dell'Indonesia. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.mccaaRating |
string La classificazione del video rilasciata dal Film Age-Classification Board di Malta. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.mcstRating |
string Il sistema di classificazione del video per il Vietnam - MCST I valori validi per questa proprietà sono:
|
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:
|
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:
|
contentDetails.contentRating.mekuRating |
string La valutazione del video rilasciata dal Kansallinen Audiovisuaalinen Instituutti (Istituto nazionale audiovisivo) finlandese. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.mibacRating |
string La valutazione del video fornita dal Ministero dei beni e delle attività culturali e del Turismo (Italia). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.mocRating |
string La valutazione del video del Ministero della cultura (Colombia). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.moctwRating |
string La classificazione del video del Ministero della cultura di Taiwan (文化部). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.mpaaRating |
string La classificazione del video della Motion Picture Association of America (MPAA). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.mpaatRating |
string Classificazione della Motion Picture Association of America relativa ai trailer dei film e all'anteprima. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.mtrcbRating |
string La classificazione del video rilasciata dal Movie and Television Review and Classification Board (Filippine). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.nbcRating |
string La classificazione del video dell'Ufficio nazionale di classificazione delle Maldive. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.nfrcRating |
string La classificazione del video assegnata dal Centro nazionale cinematografico bulgaro. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.nfvcbRating |
string La classificazione del video rilasciata dal National Film and Video Censors Board della Nigeria. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.oflcRating |
string La classificazione del video assegnata dall'Office of Film and Literature Classification (OFLC, Nuova Zelanda). I valori validi per questa proprietà sono:
|
contentDetails.contentRating.pefilmRating |
string La classificazione del video in Perù. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.resorteviolenciaRating |
string La classificazione del video in Venezuela. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.rtcRating |
string La classificazione della Direzione generale di radio, televisione e cinematografia (Messico) del video. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.rteRating |
string La classificazione del video da parte della Raidió Teilifís Éireann irlandese. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.russiaRating |
string La classificazione del National Film Registry della Federazione Russa (MKRF - Russia) del video. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.skfilmRating |
string La valutazione del video in Slovacchia. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.smaisRating |
string La classificazione del video in Islanda. I valori validi per questa proprietà sono:
|
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:
|
contentDetails.contentRating.tvpgRating |
string La classificazione TV Parental Guidelines (TVPG) del video. I valori validi per questa proprietà sono:
|
contentDetails.contentRating.ytRating |
string Una classificazione utilizzata da YouTube per identificare i contenuti con limiti di età. I valori validi per questa proprietà sono:
|
contentDetails.projection |
string Specifica il formato di proiezione del video. I valori validi per questa proprietà sono:
|
contentDetails.hasCustomThumbnail |
boolean Indica se l'utente che ha caricato il video ha fornito una 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:
|
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:
|
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:
|
status.privacyStatus |
string Lo stato della privacy del video. I valori validi per questa proprietà sono:
|
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à:
|
status.license |
string Licenza del video. I valori validi per questa proprietà sono:
|
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. Queste statistiche sono visibili per impostazione predefinita e statistiche come il numero di visualizzazioni e i voti 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 A/S.Alcuni esempi di contenuti di questo tipo sono i video che:
|
statistics |
object L'oggetto statistics contiene le 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 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 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 per il 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.
|
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 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 a partire dal 10 novembre 2016. Sarà supportata 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. |
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 del luogo in cui è stato registrato il video. |
recordingDetails.location |
object Le informazioni di 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, può essere cercato nei 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 ulteriori dettagli, consulta l'annuncio sul ritiro. Latitudine in gradi. |
recordingDetails.location.longitude |
double Questa proprietà è stata ritirata il 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 il video è stato registrato. 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 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 indipendentemente dal fatto che sia stato caricato un file video o un altro tipo di file. |
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:
|
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 voce dell'elenco contiene metadati dettagliati su uno stream video. |
fileDetails.videoStreams[].widthPixels |
unsigned integer La larghezza in pixel dei contenuti video codificati. Puoi calcolare le proporzioni di codifica del video come width_pixels / height_pixels . |
fileDetails.videoStreams[].heightPixels |
unsigned integer L'altezza dei contenuti video codificati in pixel. |
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:
|
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 voce 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. Solitamente, 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. Attualmente sono supportati i seguenti formati ISO 8601:
|
processingDetails |
object L'oggetto processingDetails include informazioni sui progressi 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 completi 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:
|
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 può 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:
|
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 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 causano problemi di elaborazione 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 include i 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 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:
|
suggestions.processingWarnings[] |
list Un elenco di motivi per cui YouTube potrebbe riscontrare difficoltà nella transcodifica del video caricato o che potrebbe 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:
|
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:
|
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 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:
|
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 alla fine 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 restituiti dalla YouTube Data API potrebbe
essere diverso dal numero di spettatori simultanei elaborati e privi di spam disponibili 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 live con chat live. Una volta completate le transizioni per la 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. |