O YouTube Reporting API e o YouTube Analytics API oferecem suporte ao protocolo OAuth 2.0 para autorizar o acesso a dados particulares do usuário. A lista abaixo explica alguns dos principais conceitos de OAuth 2.0:
-
Na primeira tentativa de uso da funcionalidade no aplicativo que exige que o usuário faça login em um Google Account or YouTube account, o aplicativo inicia o processo de autorização OAuth 2.0.
-
Seu aplicativo redireciona o usuário ao servidor de autorização do Google. O link para essa página especifica o
scopede acesso que seu aplicativo está solicitando para a conta do usuário. Oscopeespecifica os recursos que o aplicativo pode recuperar, inserir, atualizar ou excluir ao agir como usuário autenticado. -
Se o usuário consentir em autorizar seu aplicativo para acessar os recursos, o Google retorna um token a seu aplicativo. Dependendo do tipo do aplicativo, ele valida ou token ou troca-o por um tipo de token diferente.
Por exemplo, um aplicativoda Web do lado do servidor troca o token retornado por um token de acesso e um token de atualização. Com o token de acesso, o aplicativo pode autorizar solicitações em nome do usuário. Já o token de atualização permite que o aplicativo recupere um novo token de acesso quando o token de acesso original expirar.
Importante:para usar a autorização do OAuth 2.0, você precisa conseguir as credenciais de autorização no Console de APIs do Google.
Fluxos do OAuth 2.0
As APIs do Google são compatíveis com vários casos de uso do OAuth 2.0:
- O fluxo de apps da Web do lado do servidor é compatível com aplicativos da Web que podem armazenar informações persistentes com segurança.
- O fluxo de apps da Web JavaScript é compatível com aplicativos JavaScript em execução em um navegador.
- O fluxo de apps para dispositivos móveis e computador oferece suporte a aplicativos instalados em um dispositivo, como um smartphone ou computador.
- O fluxo OAuth 2.0 para TVs e dispositivos de entrada limitada oferece suporte a dispositivos com recursos de entrada limitados, como consoles de jogos e câmeras de vídeo. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
- O fluxo OAuth 2.0 para o fluxo da conta de serviço oferece suporte a interações de servidor para servidor que não acessam as informações do usuário. No entanto, YouTube Reporting API e YouTube Analytics API não são compatíveis com esse fluxo. 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.
Identificar escopos de acesso
Os escopos permitem que seu aplicativo solicite acesso apenas aos recursos necessários permitindo que os usuários controlem a quantidade de acesso que eles concedem ao aplicativo. Portanto, há pode ser uma relação inversa entre o número de escopos solicitados e a probabilidade de obter o consentimento do usuário.
Antes de começar a implementar a autorização do OAuth 2.0, recomendamos que você identifique os escopos que o app precisa de permissão para acessar.
A API YouTube Analytics usa os seguintes escopos:
| Scopes | |
|---|---|
| https://www.googleapis.com/auth/youtube | Gerenciar sua conta do YouTube |
| https://www.googleapis.com/auth/youtube.readonly | Visualize sua conta do YouTube |
| https://www.googleapis.com/auth/youtubepartner | Visualize e gerencie seus ativos e conteúdo associado no YouTube |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Visualize relatórios monetários e não monetários do YouTube Analytics para seu conteúdo do YouTube |
| https://www.googleapis.com/auth/yt-analytics.readonly | Visualize relatórios do YouTube Analytics para seu conteúdo do YouTube |
A API YouTube Reporting usa os seguintes escopos:
| Scopes | |
|---|---|
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Visualize relatórios monetários e não monetários do YouTube Analytics para seu conteúdo do YouTube |
| https://www.googleapis.com/auth/yt-analytics.readonly | Visualize relatórios do YouTube Analytics para seu conteúdo do YouTube |
O documento Escopos da API OAuth 2.0 contém um lista de escopos que você pode usar para acessar as APIs do Google.