Autenticação com os serviços Google

Se o seu script utilizar os serviços Google, como o Google Drive, o Folhas de cálculo e o Mail, precisa de obter credenciais. Existem algumas opções para obter as credenciais:

  • Opção 1 — Fácil de seguir e leva menos tempo, mas você precisa repeti-lo a cada hora quando o token de acesso expira.
  • Opção 2 — Um pouco mais complicada, mas você só precisa repeti-la se o token de atualização se tornar inválido.
  • Opção 3 — também um pouco mais complicada (utiliza o script do PowerShell fornecido), mas só precisa de repeti-la se o token de atualização se tornar inválido.

Opção 1 – Obter um token de acesso a partir do parque infantil OAuth do Google

  1. Ir para o parque infantil OAuth do Google
  2. Em Introduzir os seus próprios âmbitos, colar https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/gmail.send
  3. Selecione Autorizar APIs
  4. Depois que as APIs forem autorizadas, selecione Código de autorização do Exchange para tokens
  5. Copiar o valor do access_token da resposta
  6. Em soluções como Descobrir anúncios reprovados, que acessam serviços do Google, defina o campo do objeto de credenciais como o token de accessToken acesso copiado na etapa 5.

Nota

Como o token de acesso expira em 1 hora, você precisará repetir essas etapas a cada hora.

Opção 2 – Obter um token de atualização a partir do parque infantil OAuth do Google

  1. Aceder ao dashboard da API da consola do programador do Google
  2. Selecione Criar um projeto para criar um novo projeto ou selecionar um projeto existente
    1. Se estiver a criar um novo projeto, introduza o nome do projeto em Nome do Projeto. Por exemplo, Scripts.
    2. Selecione Criar
  3. No Dashboard, selecione ATIVAR APIS E SERVIÇOS
  4. Na caixa de pesquisa, introduza folhas e selecione API do Folhas de cálculo do Google. Em seguida, selecione ATIVAR
  5. Voltar ao painel (selecione APIs & Serviços) e repita as etapas 3 e 4 para a API do Google Drive
  6. Voltar ao dashboard (selecione APIs & Serviços) e repita os passos 3 e 4 para a API do Gmail
  7. No Dashboard, selecione Credenciais no painel de navegação esquerdo e, em seguida, selecione CONFIGURAR ECRÃ DE CONSENTIMENTO. Se lhe for pedido para selecionar um Tipo de Utilizador, selecione Externo e, em seguida, selecione Criar
  8. Digite o nome do seu aplicativo no campo Nome do aplicativo (por exemplo, cliente Scripts) e insira seu e-mail nos campos que solicitam, em seguida, selecione SALVAR E CONTINUAR
  9. Selecione ADICIONAR OU REMOVER ÂMBITOS, SELECIONE .. /auth/drive e .. /auth/gmail.send e, em seguida, selecione Atualizar
  10. Selecione GUARDAR E CONTINUAR
  11. Selecione ADICIONAR USUÁRIOS, insira seu e-mail do Google e selecione ADICIONAR
  12. No Dashboard, selecione Credenciais no painel de navegação esquerdo e, em seguida, selecione Criar credenciais e selecione ID de cliente Oauth
  13. Selecione Tipo de aplicativo Web . Em seguida, insira um nome, como Aplicativo Web Scripts , no campo Nome . Em seguida, adicione https://developers.google.com/oauthplayground aos URIs de redirecionamento autorizados. Por fim, selecione Criar
  14. Copie o ID do cliente e o segredo do cliente para utilizar nos passos 18, 19 e 24 e, em seguida, selecione OK
  15. Ir para o parque infantil OAuth do Google
  16. Selecione o ícone Configuração do OAuth 2.0 (parece uma engrenagem no canto superior direito)
  17. Marque a caixa Usar suas próprias credenciais OAuth
  18. Cole o seu ID de Cliente no ID de Cliente OAuth
  19. Cole o segredo do cliente no segredo do cliente OAuth
  20. Em Introduzir os seus próprios âmbitos, colar https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/gmail.send
  21. Selecione Autorizar APIs e siga as instruções para fornecer consentimento

Nota

Ao autorizar APIs no playground, se vir uma caixa de diálogo que diz "Esta aplicação não está verificada", selecione Avançadas e, em seguida, Ir para [nome da aplicação] (não seguro).

  1. Depois que as APIs forem autorizadas, selecione Código de autorização do Exchange para tokens
  2. Copie o token do Refresh token para usar na etapa 24
  3. Em soluções como Descobrir anúncios reprovados, que acessam serviços do Google, defina as credenciais, clientSecretrefreshToken do objeto e clientIdos campos para os valores recebidos nas etapas 13 e 22.

Opção 3 – obter um token de atualização através de um script do PowerShell

  1. Aceder ao dashboard da API da consola do programador do Google
  2. Selecione Criar um projeto para criar um novo projeto ou selecionar um projeto existente
    1. Se estiver a criar um novo projeto, introduza o nome do projeto em Nome do Projeto. Por exemplo, Scripts.
    2. Selecione Criar
  3. No Dashboard, selecione ATIVAR APIS E SERVIÇOS
  4. Na caixa de pesquisa, introduza folhas e selecione API do Folhas de cálculo do Google. Em seguida, selecione ATIVAR
  5. Voltar ao painel (selecione APIs & Serviços) e repita as etapas 3 e 4 para a API do Google Drive
  6. Voltar ao dashboard (selecione APIs & Serviços) e repita os passos 3 e 4 para a API do Gmail
  7. No Dashboard, selecione Credenciais no painel de navegação esquerdo e, em seguida, selecione CONFIGURAR ECRÃ DE CONSENTIMENTO. Se lhe for pedido para selecionar um Tipo de Utilizador, selecione Externo e, em seguida, selecione Criar
  8. Digite o nome do seu aplicativo no campo Nome do aplicativo (por exemplo, cliente Scripts) e insira seu e-mail nos campos que solicitam, em seguida, selecione SALVAR E CONTINUAR
  9. Selecione ADICIONAR OU REMOVER ÂMBITOS, SELECIONE .. /auth/drive e .. /auth/gmail.send e, em seguida, selecione Atualizar
  10. Selecione GUARDAR E CONTINUAR
  11. Selecione ADICIONAR USUÁRIOS, insira seu e-mail do Google e selecione ADICIONAR
  12. No Dashboard, selecione Credenciais no painel de navegação esquerdo e, em seguida, selecione Criar credenciais e selecione ID de cliente Oauth
  13. Selecione Tipo de aplicativo de aplicativo de desktop , insira um nome (por exemplo, creds de cliente do Scripts) e selecione Criar
  14. Copie o seu ID de cliente e o segredo do cliente para utilizar nos passos 15 e 16 e, em seguida, selecione OK
  15. Crie um script do PowerShell para obter o consentimento do utilizador e um token de atualização.

Para obter um token de acesso necessita do consentimento do utilizador, a não ser que tenha um token de atualização. No entanto, como o Scripts não suporta componentes de IU, terá de obter consentimento de outra forma. Este PowerShell fornece uma opção para obter consentimento e um token de atualização.

Abra o Bloco de Notas ou o seu editor favorito e copie o script do PowerShell para o editor. Defina $clientId o ID do $clientSecret cliente e o segredo que você recebeu quando registrou seu aplicativo (consulte a etapa 13).

$clientId = "your-client-id"
$clientSecret = "your-client-secret"

$scopes = "https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/gmail.send"

Start-Process "https://accounts.google.com/o/oauth2/v2/auth?client_id=$clientId&scope=$([string]::Join("%20", $scopes))&access_type=offline&response_type=code&redirect_uri=urn:ietf:wg:oauth:2.0:oob"    
 
$code = Read-Host "Please enter the code"
   
$response = Invoke-WebRequest https://www.googleapis.com/oauth2/v4/token -ContentType application/x-www-form-urlencoded -Method POST -Body "client_id=$clientid&client_secret=$clientSecret&redirect_uri=urn:ietf:wg:oauth:2.0:oob&code=$code&grant_type=authorization_code"
  
Write-Output "Refresh token: " ($response.Content | ConvertFrom-Json).refresh_token

Guarde o ficheiro e dê-lhe um nome GetTokens.ps1 (pode atribuir-lhe o nome que pretender, mas a extensão tem de estar .ps1).

Agora, abra uma janela da consola. Para abrir uma janela da consola no Microsoft Windows, introduza o seguinte comando Executar do Windows (<Windows, botão>+r):

cmd.exe

Na linha de comandos, navegue para a pasta onde guardou GetTokens.ps1 e introduza o seguinte comando:

powershell.exe -File .\GetTokens.ps1

Quando o script do PowerShell é executado com êxito, inicia uma sessão de browser na qual introduz as suas credenciais do Google. Após o consentimento, a página web contém o código de concessão (consulte Por favor, copie este código...).

Copia o código de concessão e introduz-o na janela da consola no prompt. Em seguida, o script do PowerShell devolve um token de atualização. Copie o token de atualização. Você deve tratar o token de atualização como faria com uma senha; Se alguém se apossar dele, terá acesso aos seus recursos.

  1. Em soluções como a Descoberta de anúncios reprovados, que acessam os serviços do Google, defina as credenciais, clientSecretrefreshToken o objeto e clientIdos campos para os valores recebidos nas etapas 13 e 14.
  • Last updated on