google api python client

Cliente API do Google

Esta é a biblioteca cliente Python da API do Google para APIs baseadas em descoberta do Google. Para começar, consulte a pasta de documentos.

Esta biblioteca é considerada completa e está em modo de manutenção. Isso significa que abordaremos bugs críticos e problemas de segurança, mas não adicionaremos novos recursos.

Esta biblioteca é oficialmente suportada pelo Google. No entanto, os mantenedores deste repositório recomendam o uso de bibliotecas de cliente em nuvem para Python, sempre que possível, para o desenvolvimento de novos códigos. Para obter mais informações, visite Bibliotecas de cliente explicadas.

Lançamento da versão 2.0

A versão 2.0 do google-api-python-client inclui uma melhoria substancial na confiabilidade, em comparação com a versão 1.x, já que os documentos de descoberta agora são armazenados em cache na biblioteca, em vez de buscados dinamicamente. É altamente recomendável atualizar da v1.x para a v2.x.

Somente python 3.7 e mais recente são suportados. Se você não conseguir atualizar o python, continue usando a versão 1.x, pois continuaremos oferecendo suporte ao python 2.7+ na v1.

Os documentos de descoberta não serão mais recuperados dinamicamente quando você chamar discovery.build() . Os documentos de descoberta serão recuperados diretamente da biblioteca cliente. Novas versões desta biblioteca são lançadas semanalmente. Como resultado do armazenamento em cache dos documentos de descoberta, o tamanho deste pacote é pelo menos 50 MB maior em comparação com a versão anterior.

Consulte o Guia de migração para obter mais informações.

Documentação

Consulte a pasta docs para obter instruções mais detalhadas e documentação adicional.

Outras bibliotecas de API do Google

Os mantenedores deste repositório recomendam o uso de bibliotecas de cliente em nuvem para Python, sempre que possível, para desenvolvimento de novo código pelos seguintes motivos:

Com bibliotecas de cliente do Cloud para Python:

• Há uma biblioteca cliente separada para cada API, então você pode escolher quais bibliotecas cliente deseja baixar. Considerando que google-api-python-client é uma biblioteca cliente única para todas as APIs. Como resultado, o tamanho total do pacote google-api-python-client excede 50 MB.
• Existem controles mais rígidos para interromper alterações nas APIs subjacentes, pois cada biblioteca cliente se concentra em uma API específica.
• Há mais recursos nessas bibliotecas de cliente em nuvem, pois cada biblioteca é focada em uma API específica e, em alguns casos, as bibliotecas pertencem a equipes especializadas nessa API.
• Os desenvolvedores se beneficiarão do intellisense.

Para obter mais informações, visite Bibliotecas de cliente explicadas.

Embora haja muitos benefícios em migrar para bibliotecas de cliente em nuvem para Python, os mantenedores querem enfatizar que google-api-python-client continuará a ter suporte.

Para a API do Google Ads, recomendamos o uso da biblioteca cliente da API do Google Ads para Python.

Para a API Google Firebase Admin, recomendamos o uso do Firebase Admin Python SDK.

Instalação

Instale esta biblioteca em um virtualenv usando pip. virtualenv é uma ferramenta para criar ambientes Python isolados. O problema básico que ele aborda é o de dependências e versões e, indiretamente, de permissões.

Com o virtualenv, é possível instalar esta biblioteca sem precisar de permissões de instalação do sistema e sem entrar em conflito com as dependências do sistema instalado.

Mac/Linux

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

Windows

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

Versões Python suportadas

Python 3.7, 3.8, 3.9, 3.10, 3.11 e 3.12 são totalmente suportados e testados. Esta biblioteca pode funcionar em versões posteriores do 3, mas atualmente não executamos testes nessas versões.

Versões Python não suportadas

Pitão <3,7

Bibliotecas e dependências de terceiros

As seguintes bibliotecas serão instaladas quando você instalar a biblioteca cliente:

• httplib2
• modelo de uri

Para desenvolvimento você também precisará das seguintes bibliotecas:

• WebTest
• pyopenssl

Contribuindo

Consulte nosso Guia de Contribuição. Em particular, adoramos solicitações pull - mas certifique-se de assinar o contrato de licença do contribuidor.