Crie um aplicativo de linha de comando Python que faça solicitações para a API Google Slides.
Os tutoriais rápidos explicam como configurar e executar um app que chama uma API do Google Workspace. Este guia de início rápido usa uma abordagem de autenticação simplificada que é adequada para um ambiente de teste. Para um ambiente de produção, recomendamos que você aprenda sobre autenticação e autorização antes de escolher as credenciais de acesso adequadas para o app.
Este guia de início rápido usa as bibliotecas de cliente de API recomendadas do Google Workspace para processar alguns detalhes do fluxo de autenticação e autorização.
Objetivos
- Prepare o ambiente.
- Instale a biblioteca de cliente.
- Configure a amostra.
- Execute a amostra.
Pré-requisitos
Para executar este guia de início rápido, você precisa dos seguintes pré-requisitos:
- Python 3.10.7 ou mais recente
- A ferramenta de gerenciamento de pacotes pip
- Um projeto do Google Cloud.
- Uma Conta do Google
Configurar o ambiente
Para concluir este guia de início rápido, configure seu ambiente.
Ativar a API
Antes de usar as APIs do Google, você precisa ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.No console do Google Cloud, ative a API Google Slides.
Configurar a tela de permissão OAuth
Se você estiver usando um novo projeto do Google Cloud para concluir este guia de início rápido, configure a tela de consentimento do OAuth. Se você já concluiu esta etapa para seu projeto do Cloud, pule para a próxima seção.
- No console do Google Cloud, acesse Menu > > Marca.
- Se você já tiver configurado o , poderá configurar as seguintes configurações da tela de consentimento do OAuth em Marca, Público-alvo e Acesso a dados. Se você receber a mensagem ainda não configurado, clique em Começar:
- Em Informações do app, em Nome do app, insira um nome para o app.
- Em E-mail para suporte do usuário, escolha um endereço de e-mail de suporte para que os usuários entrem em contato com você se tiverem dúvidas sobre o consentimento.
- Clique em Próxima.
- Em Público, selecione Interno.
- Clique em Próxima.
- Em Dados de contato, insira um endereço de e-mail para receber notificações sobre as mudanças no projeto.
- Clique em Próxima.
- Em Concluir, analise a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a política de dados do usuário dos serviços de API do Google.
- Clique em Continuar.
- Clique em Criar.
- Por enquanto, você pode pular a adição de escopos. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, será necessário mudar o Tipo de usuário para Externo. Em seguida, adicione os escopos de autorização necessários para o app. Para saber mais, consulte o guia completo Configurar a permissão OAuth.
Autorizar credenciais para um aplicativo para computador
Para autenticar usuários finais e acessar dados do usuário no app, crie um ou mais IDs do cliente OAuth 2.0. Um ID do cliente é usado para identificar um único app nos servidores OAuth do Google. Se o app for executado em várias plataformas, crie um ID do cliente separado para cada plataforma.- No console do Google Cloud, acesse Menu > > Clientes.
- Clique em Criar cliente.
- Clique em Tipo de aplicativo > App para computador.
- No campo Nome, digite um nome para a credencial. Esse nome é mostrado apenas no console do Google Cloud.
- Clique em Criar.
A credencial recém-criada aparece em "IDs de cliente OAuth 2.0".
- Salve o arquivo JSON baixado como
credentials.json
e mova-o para o diretório de trabalho.
Instalar a biblioteca de cliente do Google
Instale a biblioteca de cliente do Google para Python:
pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
Configurar a amostra
- No diretório de trabalho, crie um arquivo chamado
quickstart.py
. Inclua o seguinte código em
quickstart.py
:
Executar a amostra
No diretório de trabalho, crie e execute o exemplo:
python3 quickstart.py
-
Na primeira vez que você executar o exemplo, será necessário autorizar o acesso:
- Faça login na sua Conta do Google, caso ainda não tenha feito. Se você tiver feito login em várias contas, selecione uma para usar na autorização.
- Clique em Aceitar.
O aplicativo Python é executado e chama a API Google Slides.
As informações de autorização são armazenadas no sistema de arquivos. Assim, na próxima vez que você executar o código de exemplo, não será necessário fazer a autorização.
Próximas etapas
- Resolver problemas de autenticação e autorização
- Documentação de referência da API Slides
- Documentação do cliente das APIs do Google para Python
- Documentação da API Google Slides PyDoc