Implementare l'autorizzazione OAuth 2.0

YouTube Reporting API e YouTube Analytics API supportano il protocollo OAuth 2.0 per autorizzare l'accesso ai dati privati dell'utente. Il seguente elenco spiega alcuni concetti fondamentali di OAuth 2.0:

  • Quando un utente tenta per la prima volta di utilizzare le funzionalità della tua applicazione che richiedono 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 si comporta come l'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 tipo diverso 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.

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 in grado di archiviare in modo sicuro informazioni permanenti.
  • Il flusso App web JavaScript supporta le applicazioni JavaScript in esecuzione in un browser.
  • Il flusso di app mobile e desktop supporta le applicazioni installate su un dispositivo, come un telefono o un computer.
  • Il flusso OAuth 2.0 per TV e dispositivi con input limitato supporta i dispositivi con capacità di input limitate, come console per videogiochi e videocamere. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
  • Il flusso OAuth 2.0 per gli account di servizio supporta le interazioni server-server che non accedono alle informazioni degli utenti. Tuttavia, YouTube Reporting API e YouTube Analytics API non supportano 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 an error.

Identificare gli ambiti di accesso

Gli ambiti consentono all'applicazione di richiedere l'accesso solo alle risorse di cui ha bisogno, permettendo al contempo agli utenti di controllare il livello di accesso che concedono all'applicazione. Pertanto, potrebbe esistere una relazione inversa tra il numero di ambiti richiesti e la probabilità di ottenere il consenso degli utenti.

Prima di iniziare a implementare l'autorizzazione OAuth 2.0, ti consigliamo di identificare gli ambiti a cui la tua app dovrà disporre dell'autorizzazione per accedere.

L'API YouTube Analytics utilizza i seguenti ambiti:

范围
https://www.googleapis.com/auth/youtube管理您的 YouTube 账号
https://www.googleapis.com/auth/youtube.readonly查看您的 YouTube 账号
https://www.googleapis.com/auth/youtubepartner查看和管理您在 YouTube 上的资源和关联内容
https://www.googleapis.com/auth/yt-analytics-monetary.readonly查看您的 YouTube 内容的财务类和非财务类 YouTube Analytics 报表
https://www.googleapis.com/auth/yt-analytics.readonly查看 YouTube 分析工具为您的 YouTube 内容出具的报告

L'API YouTube Reporting utilizza i seguenti ambiti:

范围
https://www.googleapis.com/auth/yt-analytics-monetary.readonly查看您的 YouTube 内容的财务类和非财务类 YouTube Analytics 报表
https://www.googleapis.com/auth/yt-analytics.readonly查看 YouTube 分析工具为您的 YouTube 内容出具的报告

Il documento Ambiti API OAuth 2.0 contiene un elenco completo degli ambiti che potresti utilizzare per accedere alle API di Google.