Nota:l'API YouTube Content ID è destinata ai partner per i contenuti di YouTube e non è accessibile a tutti gli sviluppatori o a tutti gli utenti di YouTube. Se l'API YouTube Content ID non rientra tra i servizi elencati nella console API di Google, visita il Centro assistenza YouTube per scoprire di più sul Programma partner di YouTube.
Contesto
Un account di servizio è un Account Google che può essere utilizzato per autorizzare le chiamate API senza alcuna interazione da parte dell'utente. A differenza degli altri flussi OAuth 2.0, l'autenticazione e l'autorizzazione dell'accesso tramite il flusso OAuth 2.0 per gli account di servizio non avvengono in un browser web. OAuth 2.0 per gli account di servizio si basa invece sulle firme crittografiche per autorizzare l'accesso. Finché il tuo codice ha accesso alla chiave di crittografia sottostante, può continuare a effettuare chiamate API senza preoccuparsi dei token di aggiornamento e accesso. È perfetto per le applicazioni automatizzate in esecuzione sui server senza intervento umano.
Ora puoi utilizzare OAuth 2.0 per gli account di servizio per autorizzare le richieste API di YouTube Content ID. Puoi utilizzare questo flusso anche per autorizzare le chiamate API di dati di YouTube e API di YouTube Analytics a metodi che supportano i parametri di delega. In tutti questi casi, un'applicazione che utilizza questo flusso autorizza la richiesta API come partner dei contenuti di YouTube (utilizzando un account YouTube CMS) anziché come proprietario di un canale YouTube.
Configura l'account di servizio
I seguenti screenshot illustrano la procedura di creazione di un account di servizio associato al tuo progetto API, che devi assicurarti di aver già attivato le API appropriate (API di dati di YouTube v3, API di YouTube Analytics, API di Content ID di YouTube e così via).
- Visita https://cloud.google.com/console e scegli il tuo progetto API esistente (o creane uno nuovo).
- Nella barra laterale a sinistra, seleziona API e autenticazione.
- Assicurati che l'API YouTube Content ID sia attivata per il tuo progetto.
- Nella barra laterale a sinistra, seleziona Credenziali.
- Fai clic sul pulsante Crea nuovo ID client.
- Scegli Account di servizio dalle opzioni elencate e fai clic su Crea ID client. La chiave privata del tuo account di servizio verrà scaricata sul computer. Questa è l'unica copia della chiave e devi salvarla in una posizione sicura da cui l'applicazione possa leggere.
- Prendi nota dell'indirizzo email dell'account di servizio. L'indirizzo email viene visualizzato nella pagina Credenziali. Avrai bisogno dell'indirizzo per consentire al tuo account di servizio di accedere al tuo account YouTube CMS.
- Visita la pagina https://www.youtube.com/content_owner_users e fai clic sul pulsante Nuovo utente.
- Inserisci l'indirizzo email dell'account di servizio del passaggio 7 nel campo Indirizzo email e scegli il ruolo appropriato per l'utente. Quindi, fai clic sul pulsante Invita.
- Il tuo account di servizio accetta automaticamente l'invito e tale account può successivamente accedere alle API di YouTube che agiscono per conto del tuo account YouTube CMS.
- Per autorizzare le richieste utilizzando il tuo account di servizio, segui le istruzioni relative al flusso dell'account di servizio OAuth 2.0 nella guida relativa all'autorizzazione delle richieste.
Effettua chiamate API
Le librerie client della maggior parte dei linguaggi offrono il supporto nativo per OAuth 2.0 per il flusso dell'account di servizio. Dovresti essere in grado di seguire gli esempi nella documentazione della libreria per eseguire l'autorizzazione di base con gli ambiti dell'API di YouTube appropriati.
La cosa più importante da tenere presente è che devi utilizzare i parametri di delega appropriati per agire per conto di un determinato canale collegato al tuo account CMS. Per visualizzare un elenco dei canali collegati al tuo account CMS, visita la pagina https://cms.youtube.com/edit_user_accounts.