Nota:la pagina Rispettare le Norme per gli sviluppatori di YouTube fornisce indicazioni ed esempi per aiutarti ad assicurarti che i tuoi client API rispettino parti specifiche dei Termini e delle Norme dei servizi API di YouTube (Termini di servizio API). La guida offre informazioni su come YouTube applica determinati aspetti dei TdS dell'API, ma non sostituisce i documenti esistenti.
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").
Questi requisiti e queste linee guida garantiscono che i client API offrano un'esperienza utente coerente che protegga gli interessi di utenti, proprietari di contenuti e inserzionisti di YouTube. Queste regole fanno parte integrante dei Termini di servizio delle API di YouTube e devono essere rispettate durante lo sviluppo e l'implementazione di qualsiasi client API.
Tieni presente che i requisiti riportati in questo documento potrebbero cambiare per garantire esperienze utente migliori con le funzionalità di YouTube esistenti. Inoltre, cambieranno in base alle funzionalità di YouTube nuove e aggiornate. A volte, queste modifiche potrebbero richiedere l'aggiornamento dei client API per soddisfare i nuovi requisiti. La cronologia delle revisioni dei Termini di servizio documenta tutte le modifiche, quindi controlla spesso questo documento o iscriviti al relativo feed RSS per assicurarti di conoscere rapidamente le modifiche che potrebbero interessare i tuoi client API.
Oltre ai requisiti descritti in questo documento, ti consigliamo vivamente di seguire le best practice descritte nelle Norme relative ai servizi API di YouTube e discusse altrove nella documentazione dei servizi API di YouTube. Anche se non sono strettamente necessarie, queste pratiche aiutano i client API a riprendersi più rapidamente dagli errori e a ottimizzare l'utilizzo della quota se utilizzano servizi API di YouTube che allocano la quota. Allo stesso tempo, queste pratiche contribuiscono a garantire la salute dell'ecosistema di YouTube e, soprattutto, a offrire la migliore esperienza possibile agli utenti dei tuoi client API e delle applicazioni di YouTube.
Player incorporato di YouTube e riproduzione video
I requisiti riportati in questa sezione si riferiscono nello specifico ai player di YouTube incorporati. Le Norme relative ai servizi API di YouTube includono anche diverse norme pertinenti ai client API che riproducono contenuti audiovisivi di YouTube.
Dimensioni 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.
Riproduzione automatica e riproduzioni basate su script
Questa sezione riguarda le riproduzioni automatiche. Si applica ai player incorporati di YouTube che utilizzano il parametro del player autoplay o avviano in modo programmatico la riproduzione automatica utilizzando il servizio dell'API YouTube IFrame Player o un altro servizio dell'API YouTube.
-
I player incorporati che riproducono automaticamente un video devono avviare la riproduzione immediatamente al caricamento della pagina 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 non è visibile nella pagina o nella schermata.
-
Una pagina o una schermata non deve avere più di un player di YouTube che riproduce automaticamente i contenuti contemporaneamente.
-
Qualsiasi miniatura di YouTube che avvia la riproduzione deve avere una larghezza di almeno 120 pixel e un'altezza di almeno 70 pixel.
Attributi del player di YouTube
Gli attributi e i parametri del player di YouTube, ad esempio l'aspetto del branding di YouTube nel player, sono specificati nella documentazione e nelle specifiche dell'API YouTube (https://developers.google.com/youtube). Non devi apportare modifiche al player di YouTube non descritte esplicitamente dalla documentazione dell'API.
Overlay e cornici
Non devi mostrare overlay, frame o altri elementi visivi davanti a nessuna parte di un player di YouTube incorporato, 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 eventi di passaggio del mouse o tocco su un player di YouTube per avviare azioni per conto dell'utente, ad esempio l'apertura di una finestra o l'iscrizione a un canale.
Caricamento dei video
Se i client API consentono agli utenti di caricare contenuti su più piattaforme, questi devono essere in grado di selezionare e deselezionare le piattaforme su cui vogliono caricare i video.
Requisiti dei dati
I client API che consentono agli utenti di caricare video su YouTube devono consentire agli utenti di impostare i valori nel seguente elenco. Le proprietà non 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, ad eccezione di < e >.
| |
snippet.description |
Required. La descrizione del video. YouTube restituisce un errore se il valore supera i 5000 byte. YouTube supporta tutti i caratteri UTF-8 validi, ad eccezione di < e >. |
|
status.privacyStatus |
Required. Le impostazioni della privacy del video. Gli utenti devono poter scegliere se il video caricato sarà pubblico, privato o non in elenco. | |
| Parametri di richiesta | ||
onBehalfOfContentOwnerChannel |
Obbligatorio condizionalmente. 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) visualizzare il testo completo di un commento o di una risposta ai commenti 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 (video, canali e così via). Tieni presente che il valore della proprietà snippet.topLevelComment della risorsa commentThread è una risorsa comment e la proprietà replies.comments[] è un elenco di risorse comment. 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.
|
|
snippet.title( video) |
Obbligatorio (suggerimento). Il titolo del video. Questo valore deve essere visualizzato se il commento riguarda un video. | |
snippet.moderationStatus |
Obbligatorio condizionalmente. Se il valore del parametro moderationStatus nella richiesta API è heldForReview o likelySpam, la visualizzazione deve identificare chiaramente lo stato utilizzando il valore della proprietà, un linguaggio simile (ad es. "Questo commento è in attesa di revisione"), un'intestazione (ad es. "In attesa di revisione") o un altro linguaggio non ambiguo. Il metodo commentThreads.list supporta la possibilità di recuperare i commenti in base al loro stato di moderazione. |
|
Aggiunta di commenti
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.title( channel) |
Required. Il titolo del canale.
|
|
snippet.title( video) |
Required. Se l'utente aggiunge un commento su un video, il client API deve mostrare il titolo del video. | |
| Altri requisiti | ||
Comment author's channel name |
Required. Il client API deve identificare chiaramente l'account utente di 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. |
|
Aggiunta di risposte ai commenti
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.textDisplay |
Required. Il testo del commento. Il client API deve visualizzare 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.
|
|
snippet.title( video) |
Required. Se l'utente risponde a un commento su un video, il client API deve mostrare il titolo del video. | |
| Altri requisiti | ||
Comment author's channel name |
Required. Il client API deve identificare chiaramente l'account utente di 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 anche essere in grado di specificare il canale YouTube a cui verrà attribuita la risposta al commento. |
|
Modificare o eliminare le risposte ai commenti
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.textDisplay |
Required. Il testo del commento. Il client API deve visualizzare 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.
|
|
snippet.title( video) |
Required. Se l'utente sta modificando o eliminando un commento su un video, il client API deve mostrare il titolo del video. | |
| Altri requisiti | ||
Comment author's channel name |
Required. Il client API deve identificare chiaramente l'account utente di YouTube a cui è attribuito il commento. | |
Escludere un utente dalla chat live (o rimuovere un ban)
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.title( channel) |
Required. Il nome del canale YouTube che viene bannato o sbannato. Inoltre, il nome deve includere un link 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 di YouTube utilizzato per aggiungere o rimuovere il divieto. | |