Videos

Una risorsa video rappresenta un video di YouTube.

Metodi

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

getRating
Recupera le valutazioni che l'utente autorizzato ha assegnato a un elenco di video specificati. Prova subito.
list
Restituisce un elenco di video che corrispondono ai parametri della richiesta API. Prova subito.
batchGetStats
Recupera un elenco di statistiche sui video che corrispondono ai parametri della richiesta 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
Aggiungi un Mi piace o un Non mi piace a un video o rimuovi una valutazione da un video. Prova subito.
reportAbuse
Segnala un video perché contiene contenuti illeciti. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

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 il titolo, la descrizione e la categoria.
snippet.publishedAt datetime
La data e l'ora di pubblicazione del video. Questo orario potrebbe essere diverso da quello di caricamento del video. Ad esempio, se un video viene caricato come privato e poi reso pubblico in un secondo momento, questa proprietà specificherà l'ora in cui il video è stato reso pubblico.

Esistono alcuni casi speciali:
  • Se un video viene caricato come video privato e i metadati del video vengono recuperati dal proprietario del canale, il valore della proprietà specifica la data e l'ora in cui è stato caricato il video.
  • Se un video viene caricato come non in elenco, il valore della proprietà specifica anche la data e l'ora in cui è stato caricato. In questo caso, chiunque conosca l'ID video univoco può recuperare i metadati del video.
  • Se un video viene caricato come video per soli abbonati, il valore della proprietà specifica la data e l'ora del caricamento.
Il valore è specificato nel formato ISO 8601.
snippet.channelId string
L'ID utilizzato da YouTube per identificare in modo univoco il canale in cui è stato caricato il video. Questo valore può cambiare nel tempo, ad esempio quando un video viene riassegnato a un altro canale (ad esempio un canale tematico o un Canale ufficiale dell'artista).
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 >.

Puoi creare i capitoli del video includendo timestamp formattati (ad esempio, 00:00) nel testo della descrizione.
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 fa riferimento a un video, ad esempio un elemento di una playlist o un risultato di ricerca, ha una larghezza di 120 px e un'altezza di 90 px. La miniatura predefinita per un canale è larga 88 px e alta 88 px.
  • medium: una versione a risoluzione più elevata dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 320 px e alta 180 px. Per un canale, questa immagine è larga 240 px e alta 240 px.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine è larga 480 px e alta 360 px. Per un canale, l'immagine è larga 800 px e alta 800 px.
  • standard: una versione dell'immagine in miniatura con una risoluzione ancora più alta 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: una versione ad alta risoluzione 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 ha una larghezza di 1280 px e un'altezza di 720 px.
  • fhd: la versione Full HD (1080p) dell'immagine in miniatura. Questa dimensione dell'immagine è disponibile per alcuni video. Questa immagine è larga 1920 px e alta 1080 px.
  • qhd: la versione Quad HD (1440p / 2K) dell'immagine in miniatura. Questa dimensione dell'immagine è disponibile per alcuni video. Questa immagine è larga 2560 px e alta 1440 px.
  • uhd: la versione ad altissima risoluzione (4K) della miniatura. Questa dimensione dell'immagine è disponibile per alcuni video. Questa immagine ha una larghezza di 3840 px e un'altezza di 2160 px.
snippet.thumbnails.(key).url string
L'URL dell'immagine.
snippet.thumbnails.(key).width unsigned integer
La larghezza dell'immagine.
snippet.thumbnails.(key).height unsigned integer
L'altezza dell'immagine.
snippet.channelTitle string
Titolo del canale a cui appartiene il video.
snippet.tags[] list
Un elenco di tag di parole chiave associati al video. I tag possono contenere spazi. Il valore della proprietà ha una lunghezza massima di 500 caratteri. Tieni presente le seguenti regole relative al modo in cui viene calcolato il limite di caratteri:
  • Il valore della proprietà è un elenco e le virgole tra gli elementi 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 live imminente/attiva. Il suo valore è none se il video non è una trasmissione live imminente o 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 o 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 viene specificato un valore parametro hl o se viene 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 localizzata del video.
snippet.defaultAudioLanguage string
La proprietà default_audio_language specifica la lingua parlata nella traccia audio predefinita del video.
contentDetails object
L'oggetto contentDetails contiene informazioni sui contenuti video, tra cui la durata del video e un'indicazione della disponibilità dei sottotitoli codificati 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 rispettivamente alla durata in minuti e secondi. I # caratteri che precedono le lettere M e S sono entrambi numeri interi che specificano il numero di minuti (o secondi) del video. Ad esempio, un valore di 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 # 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 sono disponibili per il video.

I valori validi per questa proprietà sono:
  • false
  • true
contentDetails.licensedContent boolean
Indica se il video rappresenta contenuti concessi in licenza, il che significa che i contenuti sono stati caricati su un canale collegato a un partner di contenuti di YouTube e poi rivendicati da quest'ultimo.
contentDetails.regionRestriction object
L'oggetto regionRestriction contiene informazioni sui paesi in cui un video è (o non è) visualizzabile. 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 suo valore, il video non verrà visualizzato in quel paese. Se questa proprietà è presente e contiene un elenco vuoto, il video è bloccato in tutti i paesi.
contentDetails.regionRestriction.blocked[] list
Un elenco di codici regione che identificano i paesi in cui il video è bloccato. Se questa proprietà è presente e un paese non è elencato nel suo valore, il video è visualizzabile in quel paese. Se questa proprietà è presente e contiene un elenco vuoto, il video è visualizzabile 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 dell'Australian Classification Board (ACB) o dell'Australian Communications and Media Authority (ACMA) del video. Le classificazioni ACMA vengono utilizzate per classificare i programmi televisivi per bambini.

I valori validi per questa proprietà sono:
  • acbC: programmi a cui è stata assegnata la classificazione 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 a cui è stata assegnata una classificazione P dall'Australian Communications and Media Authority. Questi programmi sono destinati ai bambini in età prescolare.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
La classificazione del video dell'Autorità per le Garanzie nelle Comunicazioni (AGCOM) italiana.

I valori validi per questa proprietà sono:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
La 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 video secondo la British Board of Film Classification (BBFC).

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 assegnata dal Board of Film and Video Censors della Thailandia.

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

I valori validi per questa proprietà sono:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 - 16+
  • 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 canadesi in lingua inglese. Per ulteriori informazioni, visita il sito web del Canadian Broadcast Standards Council.

I valori validi per questa proprietà sono:
  • catv14plus – 14+
  • catv18plus - 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
La classificazione del video della Canadian Radio-Television and Telecommunications Commission (CRTC) per le trasmissioni canadesi in lingua francese. Per ulteriori informazioni, visita il sito web del Canadian Broadcast Standards Council.

I valori validi per questa proprietà sono:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
La classificazione del video della 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 video secondo il Consejo de Calificación Cinematográfica (Cile).

I valori validi per questa proprietà sono:
  • ccc14 – 14+
  • ccc18 - 18+
  • 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 Comissão de Classificação de Espectáculos portoghese.

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 Canadian Home Video Rating System (CHVRS) del video.

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 Commissione di controllo dei film (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 secondo il CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) della Romania.

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

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 del Conseil supérieur de l'audiovisuel francese, che classifica i contenuti di trasmissione.

I valori validi per questa proprietà sono:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Intercettazione
  • 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 nella 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 secondo il 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 - Evaluation and Classification Board del Ministero della Cultura e del Turismo

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

I valori validi per questa proprietà sono:
  • eefilmK12 – Istruzione primaria e secondaria
  • eefilmK14 – K-14
  • 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 dal 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 invece la proprietà contentDetails.contentRating.cncRating.

La classificazione del video secondo il Centre national du cinéma et de l'image animée (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 dal 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-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Motivi che spiegano perché il video ha ricevuto la classificazione FPB (Sudafrica).
contentDetails.contentRating.fskRating string
La classificazione del video secondo la Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germania).

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 secondo l'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 secondo l'Irish Film Classification Office (IFCO - Irlanda). Per ulteriori informazioni, visita il sito web dell'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 INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) del video.

I valori validi per questa proprietà sono:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
La classificazione del video da parte del 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 secondo il Korea Media Rating Board (영상물등급위원회). Il 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 secondo il Lembaga Sensor Film indonesiano.

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+
  • 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 secondo il Kansallinen Audiovisuaalinen Instituutti (Istituto nazionale audiovisivo) finlandese.

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
Classificazione del video del Ministerio de Cultura (Colombia).

I valori validi per questa proprietà sono:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned - Vietato
  • 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 del video della Motion Picture Association of America (MPAA).

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 (Green Band - Approvato per tutti i segmenti di pubblico)
  • mpaatRb - RB (Red Band - consigliato per i maggiori di 17 anni)
contentDetails.contentRating.mtrcbRating string
La classificazione del video assegnata dal 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 secondo il Maldives National Bureau of Classification.

I valori validi per questa proprietà sono:
  • nbc12plus – 12+
  • nbc15plus – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg - PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
La classificazione del video da parte del Bulgarian National Film Center.

I valori validi per questa proprietà sono:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
La classificazione del video assegnata dal 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 del Nacionãlais Kino centrs (National Film Centre of Latvia).

I valori validi per questa proprietà sono:
  • nkclv12plus – 12+
  • nkclv18plus - 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
La classificazione dell'Office of Film and Literature Classification (OFLC - Nuova Zelanda) del video.

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 di Raidió Teilifís Éireann (Irlanda).

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

I valori validi per questa proprietà sono:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 - 16+
  • russia18 – 18+
  • 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 svedese per i media).

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 soggetti a limiti di età.

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

I valori validi per questa proprietà sono:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Indica se l'utente che ha caricato il video ha fornito un'immagine di miniatura personalizzata per il video. Questa proprietà è visibile solo all'utente che carica 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 perché non è stato possibile caricare un video. Questa proprietà è presente solo se la proprietà uploadStatus indica che il caricamento non è riuscito.

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

I valori validi per questa proprietà sono:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Lo stato della privacy del video. In una richiesta videos.insert, se non specifichi un valore per questa proprietà, lo stato di privacy del video caricato viene impostato su public per impostazione predefinita. Alcuni caricamenti potrebbero essere impostati su private per impostazione predefinita in base alle impostazioni dell'account del creator, come spiegato nel Centro assistenza YouTube. I video caricati da progetti API non verificati non sono limitati alla modalità di visualizzazione privata.

I valori validi per questa proprietà sono:
  • private
  • public
  • unlisted
status.publishAt datetime
La data e l'ora in cui è programmata 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.
  • Questa proprietà può essere impostata solo se lo stato della privacy del video è private e il video non è mai stato pubblicato.
  • Se la tua richiesta programma la pubblicazione di un video in un momento nel passato, il video verrà pubblicato immediatamente. Pertanto, l'effetto dell'impostazione della proprietà status.publishAt su una data e un'ora passate è lo stesso della modifica della proprietà 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 statistiche come il numero di visualizzazioni e le valutazioni di un video saranno comunque visibili pubblicamente anche se il valore di questa proprietà è impostato su false.
status.madeForKids boolean
Questo valore indica se il video è contrassegnato come destinato ai bambini e contiene lo stato "destinato ai bambini" corrente del video. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Per saperne di più 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 designare il video come rivolto ai minori. In una richiesta videos.list, il valore della proprietà viene restituito solo se il proprietario del canale ha autorizzato la richiesta API.
status.containsSyntheticMedia boolean
In una richiesta di videos.insert o videos.update, questa proprietà consente al proprietario del canale di dichiarare che un video contiene contenuti realistici alterati o sintetici (A/S). Scopri di più sulle norme di YouTube relative ai contenuti generati dall'IA.

Alcuni esempi di contenuti A/S includono video che:
  • Far dire o fare a una persona reale qualcosa che non ha detto o fatto
  • Alterare il filmato di un evento o un luogo reale
  • Generare una scena realistica che non è realmente avvenuta
statistics object
L'oggetto statistics contiene statistiche sul video.
statistics.viewCount unsigned long

Il numero di volte in cui il video è stato visualizzato.

A partire dal 24 agosto 2026, per tutti i formati video (nel formato lungo, live e Short) di un canale, viewCount verrà aggiornato per conteggiare le visualizzazioni nel momento in cui inizia la riproduzione di un video (sono inclusi la riproduzione automatica, il passaggio del puntatore del mouse e il clic/tocco per riprodurre).
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 resa privata il 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 saperne di più, 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. La deprecazione è 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 informazioni che utilizzeresti per riprodurre il video in un player incorporato.
player.embedHtml string
Un tag <iframe> che incorpora un player che riproduce il video.
  • Se la richiesta API per recuperare la risorsa specifica un valore per i parametri maxHeight e/o maxWidth, le dimensioni del player incorporato vengono scalate per soddisfare i requisiti di maxHeight e/o maxWidth.
  • Se le proporzioni del video non sono note, il player incorporato utilizza per impostazione predefinita un formato 4:3.
player.embedHeight long
L'altezza del player incorporato restituita nella proprietà player.embedHtml. Questa proprietà viene restituita solo se la richiesta ha specificato un valore per i parametri maxHeight e/o maxWidth e le proporzioni del video sono note.
player.embedWidth long
La larghezza del player incorporato restituita nella proprietà player.embedHtml. Questa proprietà viene restituita solo se la richiesta ha specificato un valore per i parametri maxHeight e/o maxWidth e le proporzioni del video sono note.
topicDetails object
L'oggetto topicDetails contiene informazioni sugli argomenti associati al video.

Importante: consulta le definizioni delle proprietà topicDetails.relevantTopicIds[] e topicDetails.topicIds[], nonché la cronologia delle revisioni per maggiori dettagli sulle prossime modifiche 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à 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.
topicDetails.topicCategories[] list
Un elenco di URL di Wikipedia che forniscono una descrizione generale dei contenuti del video.
recordingDetails object
L'oggetto recordingDetails contiene informazioni sulla posizione, la data e l'indirizzo in cui è stato registrato il video.
recordingDetails.locationDescription string
Questa proprietà è stata ritirata a partire dal 1° giugno 2017. Per saperne di più, consulta l'annuncio sul ritiro.

La descrizione testuale della posizione in cui è stato registrato il video.
recordingDetails.location object
Questa proprietà è stata ritirata. Tutte le relative proprietà secondarie (latitudine, longitudine, altitudine) sono ritirate.

Le informazioni sulla geolocalizzazione associate al video. I valori della proprietà secondaria 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 maggiori dettagli, consulta l'annuncio sul ritiro.

Latitudine in gradi.
recordingDetails.location.longitude double
Questa proprietà è stata ritirata il 1° giugno 2017. Per saperne di più, consulta l'annuncio sul ritiro.

Longitudine in gradi.
recordingDetails.location.altitude double
Questa proprietà è stata ritirata il 9 luglio 2018. Per maggiori 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 incapsula le informazioni sul file video caricato su YouTube, tra cui la risoluzione, la durata, i codec audio e video, i bitrate dello stream e altro ancora. Questi dati possono essere recuperati solo dal proprietario del video.

L'oggetto fileDetails verrà restituito solo se la proprietà processingDetails.fileAvailability ha un valore pari a available.
fileDetails.fileName string
Il nome del file caricato. Questo campo è presente indipendentemente dal fatto che sia 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 sia 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 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 file 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 MS Word.
  • image: il file è un file immagine, ad esempio un'immagine .jpeg.
  • other: il file è un altro tipo di file non video.
  • project: il file è un 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 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 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 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 deve essere visualizzato il video.
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'importo in base al quale YouTube deve ruotare i contenuti della sorgente originale 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 di 180 gradi.
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 di creazione del 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 incapsula le informazioni sull'avanzamento di YouTube nell'elaborazione del file video caricato. Le proprietà dell'oggetto identificano lo stato di elaborazione attuale 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 di YouTube nell'elaborazione del file video caricato. Questi dati possono essere recuperati solo dal proprietario del video.
processingDetails.processingStatus string
Lo stato di elaborazione del video. Questo valore indica se YouTube è riuscito a elaborare il video o se è ancora in fase di elaborazione.

I valori validi per questa proprietà sono:
  • failed - L'elaborazione video non è riuscita. Consulta ProcessingFailureReason.
  • processing: il video è attualmente in fase di elaborazione. Consulta ProcessingProgress.
  • succeeded: il video è stato elaborato correttamente.
  • terminated: le informazioni sull'elaborazione non sono più disponibili.
processingDetails.processingProgress object
L'oggetto processingProgress contiene informazioni sullo stato di 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 che devono essere elaborate 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 che YouTube ha già elaborato. Puoi stimare la percentuale del video che YouTube ha già elaborato calcolando:
100 * parts_processed / parts_total

Tieni presente che, poiché il numero stimato di parti potrebbe aumentare senza un corrispondente aumento del numero di parti già elaborate, è possibile che l'avanzamento calcolato possa diminuire periodicamente mentre YouTube elabora un video.
processingDetails.processingProgress.timeLeftMs unsigned long
Una stima della quantità di tempo, in millisecondi, necessaria 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 è riuscito.
  • streamingFailed: impossibile inviare il video agli streamer.
  • transcodeFailed: la transcodifica dei contenuti non è riuscita.
  • uploadFailed: la consegna del file non è riuscita.
processingDetails.fileDetailsAvailability string
Questo valore indica se i dettagli del file sono disponibili per il video caricato. Puoi recuperare i dettagli del file di un video richiedendo la parte fileDetails nella richiesta videos.list().
processingDetails.processingIssuesAvailability string
Questo valore indica se il motore di elaborazione dei video ha generato suggerimenti che potrebbero migliorare la capacità di YouTube di elaborare il video, avvisi che spiegano i problemi di elaborazione dei video o errori che causano problemi di elaborazione dei 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 consentire ad altri utenti di trovarlo più facilmente. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella tua richiesta videos.list().
processingDetails.editorSuggestionsAvailability string
Questo valore indica se sono disponibili suggerimenti per l'editing video che potrebbero migliorare la qualità video o l'esperienza di riproduzione. Puoi recuperare questi suggerimenti richiedendo la parte suggestions nella tua richiesta videos.list().
processingDetails.thumbnailsAvailability string
Questo valore indica se sono state generate immagini in miniatura per il video.
suggestions object
L'oggetto suggestions contiene suggerimenti che identificano opportunità per migliorare la qualità video o i metadati del video caricato. Questi dati possono essere recuperati solo dal proprietario del video.

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

I valori validi per questa proprietà sono:
  • archiveFile: un file di archivio (ad es. un file ZIP).
  • audioFile: il file contiene solo audio (ad es. un file MP3).
  • docFile: documento o file di testo (ad es. documento MS Word).
  • imageFile: file immagine (ad es. un'immagine JPEG).
  • notAVideoFile: altro file non video.
  • projectFile: file di progetto del film (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 i problemi che non indicano necessariamente che l'elaborazione del video non andrà a buon fine, ma che potrebbero comunque causare problemi come problemi di sincronizzazione, artefatti video o una traccia audio mancante.

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

I valori validi per questa proprietà sono:
  • nonStreamableMov: il file MP4 non è riproducibile in streaming, il che rallenterà l'elaborazione.
  • sendBestQualityVideo: probabilmente esiste una versione di qualità migliore del video.
suggestions.tagSuggestions[] list
Un elenco di tag di parole chiave che potrebbero essere aggiunti ai metadati del video per aumentare la probabilità che gli utenti trovino il tuo video durante la ricerca o la navigazione su YouTube.
suggestions.tagSuggestions[].tag string
Il tag di parole chiave suggerito per il video.
suggestions.tagSuggestions[].categoryRestricts[] list
Un insieme di categorie di video per cui il tag è pertinente. Puoi utilizzare queste informazioni per mostrare suggerimenti di tag appropriati in base alla categoria video che l'utente che carica il video associa al video. Per impostazione predefinita, i suggerimenti per i tag sono pertinenti per tutte le categorie se non sono definite limitazioni per la parola chiave.
suggestions.editorSuggestions[] list
Un elenco di operazioni di editing video che potrebbero migliorare la qualità video o l'esperienza di riproduzione del video caricato.

I valori validi per questa proprietà sono:
  • audioQuietAudioSwap: la traccia audio sembra silenziosa e potrebbe essere sostituita con una di qualità migliore.
  • videoAutoLevels: i livelli di luminosità dell'immagine sembrano errati e potrebbero essere corretti.
  • videoCrop: i margini (mascherini) rilevati intorno all'immagine potrebbero essere ritagliati.
  • videoStabilize: il video appare instabile 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 live in programma, in diretta o completata.
liveStreamingDetails.actualStartTime datetime
L'ora in cui è iniziata effettivamente la 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 la trasmissione è effettivamente terminata. Il valore è specificato nel formato ISO 8601. Questo valore non sarà disponibile fino al termine della trasmissione.
liveStreamingDetails.scheduledStartTime datetime
L'ora in cui è prevista l'inizio della trasmissione. Il valore è specificato nel formato ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
L'ora in cui è prevista 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 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 interrompe il monitoraggio del numero di spettatori simultanei per una trasmissione quando questa termina. Pertanto, questa proprietà non identifica il numero di spettatori che guardano un video archiviato di una trasmissione live già terminata.
Il numero di spettatori simultanei restituito dall'API YouTube Data potrebbe differire dal numero di spettatori simultanei elaborato e ripulito dallo spam disponibile tramite YouTube Analytics. Scopri di più sulle metriche del live streaming nel Centro assistenza YouTube.
liveStreamingDetails.activeLiveChatId string
L'ID della chat live attualmente attiva allegata a questo video. Questo campo viene compilato solo se il video è una trasmissione live in corso con chat live. Una volta completata la transizione della trasmissione, questo campo verrà rimosso e la chat live verrà chiusa. Per le trasmissioni persistenti, l'ID della chat live non sarà più associato a questo video, ma al nuovo video visualizzato nella pagina persistente.
brandPartner object
L'oggetto brandPartner contiene i dettagli sul brand partner collegato al video per l'accesso del brand partner avviato dal creator (CI BPA).
brandPartner.channelId string
L'ID canale esterno del brand partner. Questo campo deve iniziare con "UC". channelId o channelHandle deve essere impostato quando viene stabilito l'accesso, ma nella risposta viene restituito solo channelId.
brandPartner.channelHandle string
L'handle del canale del brand partner. Questo campo deve iniziare con "@". Quando si stabilisce l'accesso, è necessario impostare channelId o channelHandle, ma nella risposta viene restituito solo channelId.
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 che contiene un codice lingua BCP-47.
localizations.(key).title string
Il titolo del video localizzato.
localizations.(key).description string
La descrizione localizzata del video.