YouTube Live Streaming API supporta il protocollo OAuth 2.0 per l'autorizzazione dell'accesso ai dati utente privati. L'elenco riportato di seguito illustra alcuni concetti fondamentali di OAuth 2.0:
-
Quando un utente tenta per la prima volta di utilizzare una funzionalità della tua applicazione che richiede l'accesso a un Google Account or YouTube account, la tua applicazione avvia la procedura di autorizzazione OAuth 2.0.
-
L'applicazione indirizza l'utente al server di autorizzazione di Google. Il link a questa pagina specifica il
scope
di accesso richiesto dalla tua applicazione per l'account dell'utente.scope
specifica le risorse che l'applicazione può recuperare, inserire, aggiornare o eliminare quando agisce come utente autenticato. -
Se l'utente acconsente ad autorizzare la tua applicazione ad accedere a queste risorse, Google restituisce un token alla tua applicazione. A seconda del tipo di applicazione, convalida il token o lo scambia con un altro tipo di token.
Ad esempio, un'applicazione web lato server scambia il token restituito con un token di accesso e un token di aggiornamento. Il token di accesso consente all'applicazione di autorizzare le richieste per conto dell'utente, mentre il token di aggiornamento consente all'applicazione di recuperare un nuovo token di accesso quando quello originale scade.
Importante: per utilizzare l'autorizzazione OAuth 2.0, devi ottenere le credenziali di autorizzazione nella Console API di Google.
Per maggiori dettagli, consulta la Guida all'autorizzazione OAuth 2.0.
Nota: un canale deve essere approvato per utilizzare la funzionalità YouTube Live, che consente al proprietario del canale di trasmettere in streaming contenuti live su quel canale. Se invii richieste API per conto di un utente autenticato il cui canale non è abilitato o idoneo per lo streaming di contenuti dal vivo, l'API restituirà un errore insufficientPermissions
.
Flussi OAuth 2.0
Le API di Google supportano diversi casi d'uso di OAuth 2.0:
- Il flusso delle app web lato server supporta le applicazioni web che possono archiviare in modo sicuro informazioni permanenti.
- Il flusso App web JavaScript supporta le applicazioni JavaScript in esecuzione in un browser.
- Il flusso App mobile e desktop supporta le applicazioni installate su un dispositivo, ad esempio uno smartphone o un computer.
- Il flusso TV e dispositivi a input limitato supporta i dispositivi con funzionalità di input limitate, come console per videogiochi e videocamere.
- Il flusso OAuth 2.0 per gli account di servizio supporta le interazioni server-server che non accedono alle informazioni degli utenti.
Tuttavia, YouTube Live Streaming API non supporta questo flusso.
Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate a
NoLinkedYouTubeAccount
error.