Servizi API di YouTube - Funzionalità minima obbligatoria

Nota: la nuova guida Conformità alle Norme per gli sviluppatori di YouTube fornisce indicazioni ed esempi per aiutarti a garantire che i tuoi client API aderiscano a parti specifiche dei Termini e delle Norme dei Servizi API di YouTube. Queste indicazioni offrono informazioni su come YouTube applica determinati aspetti dei TdS dell'API, ma non sostituiscono alcun documento esistente.

Questo documento definisce i requisiti funzionali minimi per i client API che implementano o forniscono l'accesso a funzionalità specifiche dei servizi API di YouTube ("client API").

I requisiti e le linee guida garantiscono che i client API offrano un'esperienza utente coerente che protegge gli interessi degli utenti, dei proprietari dei contenuti e degli inserzionisti di YouTube. Queste regole sono parte integrante dei Termini di servizio dell'API di YouTube e devono essere seguite nello sviluppo e nell'implementazione di qualsiasi Client API.

I requisiti riportati in questo documento cambieranno per consentirci di migliorare le esperienze degli utenti con le funzionalità di YouTube esistenti. Inoltre, cambieranno in risposta alle funzionalità nuove e aggiornate di YouTube. A volte queste modifiche potrebbero richiedere l'aggiornamento dei client API per soddisfare nuove esigenze. Le cronologia delle revisioni dei Termini di servizio documenteranno le modifiche, quindi ti invitiamo a controllare questo documento di frequente o a iscriverti al suo feed RSS per assicurarti di conoscere rapidamente le modifiche che potrebbero interessare i tuoi client API.

Oltre a quelli indicati in questo documento, consigliamo vivamente di seguire le best practice descritte nelle Norme per i servizi di API di YouTube e discusse altrove nella documentazione dei servizi API di YouTube. Anche se non strettamente richiesto, queste pratiche aiutano i tuoi client API a riprendersi più velocemente dagli errori e a ottimizzare l'utilizzo della quota se utilizzano i servizi API di YouTube che allocano la quota. Allo stesso tempo, queste pratiche garantiscono l'integrità dell'ecosistema di YouTube e, soprattutto, forniscono la migliore esperienza possibile agli utenti dei tuoi client API e delle applicazioni di YouTube.

Player incorporato e riproduzione video di YouTube

I requisiti di questa sezione riguardano in modo specifico i player di YouTube incorporati. Le Norme sui servizi API di YouTube includono anche diverse norme pertinenti per i client API che riproducono contenuti audiovisivi di YouTube.

Dimensione del player di YouTube incorporato

Per i player incorporati, la visualizzazione deve essere di almeno 200 px per 200 px. Nel caso in cui siano presenti i controlli, il player dovrà avere dimensioni tali da mostrare i controlli senza ridurre la visualizzazione al di sotto del valore minimo. I player in formato 16:9 devono avere una larghezza minima di 480 pixel e un'altezza minima di 270 pixel.

Riproduzioni automatiche e con script

Questa sezione riguarda le riproduzioni automatiche. Si applica ai player incorporati di YouTube che utilizzano il parametro player autoplay o avviano in modo programmatico la riproduzione automatica utilizzando il servizio API IFrame Player di YouTube, il servizio API YouTube Android Player o un altro servizio dell'API di YouTube.

  • I player incorporati che riproducono automaticamente un video devono avviare la riproduzione immediatamente quando la pagina viene caricata o non appena il player incorporato è completamente visibile. Tuttavia, un client API non deve avviare una riproduzione automatica finché il player non è visibile e più della metà del player è visibile sulla pagina o sullo schermo.

  • Una pagina o una schermata non deve avere più di un player di YouTube che riproduce automaticamente i contenuti contemporaneamente.

  • Le miniature di YouTube che avviano una riproduzione devono essere di almeno 120 pixel in larghezza e 70 pixel in altezza.

Attributi del player di YouTube

Gli attributi e i parametri del player di YouTube, inclusi, ad esempio, l'aspetto del branding di YouTube nel player, sono specificati nella documentazione e nelle specifiche dell'API di YouTube (https://developers.google.com/youtube). Non devi apportare modifiche al player di YouTube che non siano esplicitamente descritte nella documentazione dell'API.

Overlay e frame

Non devi mostrare overlay, frame o altri elementi visivi di fronte a nessuna parte di un player incorporato di YouTube, inclusi i controlli del player. Analogamente, non devi utilizzare overlay, frame o altri elementi visivi per oscurare parti di un player incorporato, inclusi i controlli del player.

Mouse-over

Non devi utilizzare il mouseover o gli eventi di tocco su un player di YouTube per avviare un'azione per conto dell'utente, come aprire una finestra o iscriverti a un canale.

Caricamento dei video

Se i client API permettono agli utenti di caricare contenuti su più piattaforme, gli utenti devono essere in grado di selezionare e deselezionare le piattaforme su cui vogliono caricare i propri video.

Requisiti dei dati

I client API che consentono agli utenti di caricare video su YouTube devono consentire agli utenti di impostare i valori nell'elenco seguente. Le proprietà che non sono elencate sono facoltative.

  Nome Descrizione
Proprietà delle risorse
snippet.title Required. Il titolo del video. YouTube restituisce un errore se il valore supera i 100 caratteri. YouTube supporta tutti i caratteri UTF-8 validi tranne < e >.

snippet.description Required. La descrizione del video. YouTube restituisce un errore se il valore supera 5000 byte. YouTube supporta tutti i caratteri UTF-8 validi tranne < e >.
status.privacyStatus Required. Le impostazioni sulla privacy del video. Gli utenti devono poter decidere se il video caricato sarà pubblico, privato o non in elenco.
Parametri di richiesta
onBehalfOfContentOwnerChannel Obbligatorio. Se le credenziali di autorizzazione della richiesta identificano un proprietario dei contenuti e il parametro onBehalfOfContentOwner è impostato, l'utente dell'API deve anche essere in grado di specificare il canale YouTube su cui viene caricato il video.

Visualizzazione dei commenti

  Nome Descrizione
Proprietà delle risorse
snippet.textDisplay Required. Il testo del commento. Il client API deve (a) mostrare il testo completo di un commento o una risposta di commento oppure (b) troncare il testo e fornire allo spettatore un modo per accedere facilmente al testo completo dalla versione troncata.

Questo requisito si applica a tutti i commenti e alle risposte ai commenti, indipendentemente dal tipo di risorsa a cui sono associati i video (video, canali e così via).

Tieni presente che il valore della proprietà snippet.topLevelComment della risorsa commentThread è una risorsa comment e una proprietà replies.comments[] della risorsa replies.comments[]. Di conseguenza, questo requisito si applica anche alle proprietà snippet.topLevelComment.snippet.textDisplay e replies.comments[].snippet.textDisplay.
snippet.title
(channel)
Obbligatorio (suggerimento). Il titolo del canale.
  • Se il commento riguarda un canale, il client API deve visualizzare il nome del canale.
  • Se il commento riguarda un video, il client API deve visualizzare il nome del canale che ha caricato il video.
snippet.title
(video)
Condizione condizionale (suggerimento). Il titolo del video. Questo valore deve essere visualizzato se il commento riguarda un video.
snippet.moderationStatus Obbligatorio. Se il valore del parametro moderationStatus nella richiesta API è heldForReview o likelySpam, il display deve identificare chiaramente lo stato utilizzando il valore della proprietà, il linguaggio simile (ad es. "Questo commento è in attesa di revisione"), un'intestazione (ad es. "Da rivedere") o un altro linguaggio non ambiguo. Il metodo commentThreads.list supporta la possibilità di recuperare i commenti in base al loro stato di moderazione.

Aggiungere commenti

  Nome Descrizione
Proprietà delle risorse
snippet.title
(channel)
Required. Il titolo del canale.
  • Se l'utente aggiunge un commento su un canale, il client API deve visualizzare il nome del canale.
  • Se l'utente aggiunge un commento su un video, il client API deve visualizzare il nome del canale che ha caricato il video.
snippet.title
(video)
Required. Se l'utente aggiunge un commento su un video, il client API deve visualizzare il titolo del video.
Altri requisiti
Comment author's channel name Required. Il client API deve identificare chiaramente l'account utente YouTube a cui verrà attribuito il commento. Se le credenziali di autorizzazione della richiesta identificano un proprietario dei contenuti e il parametro onBehalfOfContentOwner è impostato, l'utente dell'API deve anche essere in grado di specificare il canale YouTube a cui verrà attribuito il commento.

Aggiungere risposte ai commenti

  Nome Descrizione
Proprietà delle risorse
snippet.textDisplay Required. Il testo del commento. Il client API deve mostrare il testo del commento a cui l'utente sta rispondendo, in conformità con le regole definite nella sezione Visualizzazione dei commenti di questo documento.
snippet.title
(channel)
Required. Il titolo del canale.
  • Se l'utente risponde a un commento su un canale, il client API deve visualizzare il nome del canale.
  • Se l'utente risponde a un commento su un video, il client API deve visualizzare il nome del canale che ha caricato il video.
snippet.title
(video)
Required. Se l'utente risponde a un commento su un video, il client API deve visualizzare il titolo del video.
Altri requisiti
Comment author's channel name Required. Il client API deve identificare chiaramente l'account utente YouTube a cui verrà attribuita la risposta al commento. Se le credenziali di autorizzazione della richiesta identificano un proprietario dei contenuti e il parametro onBehalfOfContentOwner è impostato, l'utente dell'API deve inoltre essere in grado di specificare il canale YouTube a cui verrà attribuita la risposta al commento.

Modificare o eliminare risposte ai commenti

  Nome Descrizione
Proprietà delle risorse
snippet.textDisplay Required. Il testo del commento. Il client API deve mostrare il testo del commento che l'utente sta modificando o eliminando in conformità con le regole definite nella sezione Visualizzazione dei commenti di questo documento.
snippet.title
(channel)
Required. Il titolo del canale.
  • Se l'utente sta modificando o eliminando un commento su un canale, il client API deve visualizzare il nome del canale.
  • Se l'utente sta modificando o eliminando un commento su un video, il client API deve visualizzare il nome del canale che ha caricato il video.
snippet.title
(video)
Required. Se l'utente sta modificando o eliminando un commento su un video, il client API deve visualizzare il titolo del video.
Altri requisiti
Comment author's channel name Required. Il client API deve identificare chiaramente l'account utente YouTube a cui è attribuito il commento.

Escludere un utente dalla chat dal vivo (o rimuovere un'esclusione)

  Nome Descrizione
Proprietà delle risorse
snippet.title
(channel)
Required. Il nome del canale YouTube escluso o escluso. Inoltre, il nome deve essere collegato al canale o l'URL del canale deve essere visualizzato.
Altri requisiti
Nome del canale dell'autore del commento Required. Il client API deve identificare chiaramente l'account utente YouTube utilizzato per aggiungere o rimuovere l'esclusione.