Nota: il rispetto delle Norme per gli sviluppatori di YouTube fornisce indicazioni ed esempi per aiutarti a garantire che i tuoi client API seguano parti specifiche dei Termini e delle Norme (TdS delle API) dei servizi API di YouTube. La guida offre approfondimenti 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 linee guida garantiscono che i client API offrano un'esperienza utente coerente che protegga gli interessi degli utenti di YouTube, dei proprietari dei contenuti e degli inserzionisti. Queste regole sono parte integrante dei Termini di servizio dell'API di YouTube e devono essere seguite durante lo sviluppo e l'implementazione dei client API.
I requisiti riportati in questo documento dovrebbero cambiare per consentirci di offrire esperienze utente migliori con le funzionalità di YouTube esistenti. Inoltre, cambieranno in risposta alle funzionalità di YouTube nuove e aggiornate. A volte, tali modifiche possono richiedere l'aggiornamento dei client API per soddisfare nuovi requisiti. La cronologia delle revisioni dei Termini di servizio documenta le modifiche, pertanto ti consigliamo di controllare di frequente il documento o di iscriverti al feed RSS per ricevere rapidamente informazioni sulle modifiche che potrebbero interessare i client API.
Oltre ai requisiti riportati in questo documento, ti consigliamo vivamente di seguire le best practice descritte nelle Norme relative ai servizi API di YouTube e descritte altrove nella documentazione dei servizi API di YouTube. Anche quando non è strettamente richiesto, queste pratiche aiutano i tuoi client API a recuperare più rapidamente dagli errori e a ottimizzare il loro utilizzo della quota se utilizzano i servizi API di YouTube che allocano la quota. Allo stesso tempo, queste pratiche contribuiscono a garantire l'integrità dell'ecosistema di YouTube e, soprattutto, a offrire la migliore esperienza possibile agli utenti dei tuoi client API e delle tue applicazioni YouTube.
Player incorporato di YouTube e riproduzione dei video
I requisiti di questa sezione riguardano in particolare i player di YouTube incorporati. Le Norme sui servizi API di YouTube includono inoltre diverse norme applicabili 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 autoplay del player o avviano in modo programmatico la riproduzione automatica utilizzando il servizio API YouTube IFrame Player, il servizio YouTube Android Player API o un altro servizio API di YouTube.
-
I player incorporati che riproducono automaticamente un video devono avviarne la riproduzione non appena viene caricata la 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 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.
-
Qualsiasi miniatura di YouTube che avvia una riproduzione deve essere larga almeno 120 pixel e alta 70 pixel.
Attributi del player di YouTube
Gli attributi e i parametri del player di YouTube, incluso, 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 al player di YouTube modifiche che non siano descritte esplicitamente nella documentazione dell'API.
Sovrapposizioni e cornici
Non è consentito mostrare overlay, frame o altri elementi visivi davanti a qualsiasi parte del player incorporato di YouTube, inclusi i controlli del player. Analogamente, non è consentito utilizzare overlay, frame o altri elementi visivi per oscurare qualsiasi parte di un player incorporato, inclusi i controlli del player.
Mouse-over
Non è consentito utilizzare eventi di tocco o mouseover su un player di YouTube per avviare azioni per conto dell'utente, come 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, gli utenti devono essere in grado di selezionare e deselezionare le piattaforme su cui caricare i video.
Requisiti relativi ai dati
I client API che consentono agli utenti di caricare video su YouTube devono consentire agli utenti di impostare i valori nel seguente elenco. Tutte le proprietà non elencate sono facoltative.
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.title |
Obbligatorio. 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 |
Obbligatorio. La descrizione del video. YouTube restituisce un errore se il valore supera i 5000 byte. YouTube supporta tutti i caratteri UTF-8 validi tranne < e >. |
|
status.privacyStatus |
Obbligatorio. Le impostazioni della privacy del video. Gli utenti devono poter scegliere se il video caricato deve essere pubblico, privato o non in elenco. | |
| Parametri di richiesta | ||
onBehalfOfContentOwnerChannel |
Obbligatoria 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 |
Obbligatorio. Il testo del commento. Il client API deve (a) visualizzare il testo completo di una risposta al commento o (b) troncare il testo e fornire al visualizzatore un modo per accedere facilmente al testo completo dalla versione troncata. Questo requisito si applica a tutti i commenti e le risposte ai commenti, indipendentemente dal tipo di risorsa a cui sono associati i commenti (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[].comment In quanto tale, 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 in modo condizionale (suggerimento). Il titolo del video. Questo valore deve essere visualizzato se il commento riguarda un video. | |
snippet.moderationStatus |
Obbligatoria condizionalmente. Se il valore del parametro moderationStatus nella richiesta API è heldForReview o likelySpam, il display deve identificare chiaramente lo stato tramite 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) |
Obbligatorio. Il titolo del canale.
|
|
snippet.title( video) |
Obbligatorio. 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 |
Obbligatorio. 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. |
|
Aggiunta di risposte ai commenti
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.textDisplay |
Obbligatorio. 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 del presente documento. | |
snippet.title( channel) |
Obbligatorio. Il titolo del canale.
|
|
snippet.title( video) |
Obbligatorio. 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 |
Obbligatorio. 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 essere anche 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 |
Obbligatorio. 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 del presente documento. | |
snippet.title( channel) |
Obbligatorio. Il titolo del canale.
|
|
snippet.title( video) |
Obbligatorio. Se l'utente sta modificando o eliminando un commento relativo a un video, il client API deve visualizzare il titolo del video. | |
| Altri requisiti | ||
Comment author's channel name |
Obbligatorio. Il client API deve identificare chiaramente l'account utente YouTube a cui viene attribuito il commento. | |
Escludere un utente dalla chat live (o rimuovere un'esclusione)
| Nome | Descrizione | |
|---|---|---|
| Proprietà delle risorse | ||
snippet.title( channel) |
Obbligatorio. Il nome del canale YouTube che è stato escluso o riammesso. Inoltre, il nome deve rimandare al canale o deve essere mostrato anche l'URL del canale. | |
| Altri requisiti | ||
| Nome del canale dell'autore del commento | Obbligatorio. Il client API deve identificare chiaramente l'account utente YouTube utilizzato per aggiungere o rimuovere l'esclusione. | |