Instalação

Seja instalando a biblioteca do PyPI ou clonando-a do GitHub, nós recomendamos que você realize as etapas abaixo usando uma conta de serviço de nuvem. Para mais informações sobre como criar e ativar uma consulte a documentação do Ambiente virtual.

Instalar o módulo do PyPI

A biblioteca é distribuída no PyPI e pode ser instalado usando pip com o seguinte comando:

python -m pip install google-ads

Instalar a biblioteca do GitHub

O código-fonte da biblioteca pode ser clonado do GitHub. na sua máquina local. É útil clonar o código-fonte para facilitar executar os exemplos ou desenvolver a própria biblioteca. Para referência, executar um dos exemplos de autenticação é uma etapa obrigatória na configuração da biblioteca para uso.

1. Verifique se python3.8 ou posterior está presente em seu ambiente. A maneira mais simples é usar pyenv:

   pyenv local 3.8
   

2. Clone a biblioteca de cliente do GitHub:

   git clone git@github.com:googleads/google-ads-python.git
   

3. Insira o repositório e instale-o:

   cd google-ads-python
   python -m pip install .
   

4. Se você pretende desenvolver a biblioteca, execute os testes de unidade antes e depois fazer alterações:

   1. Verifique se você tem todas as versões compatíveis da linguagem Python disponíveis no em seu ambiente. Usando pyenv:

      pyenv local 3.8 3.9 3.10 3.11 3.12
      

   2. Instale as dependências específicas de teste da biblioteca:

      python -m pip install .[tests]
      

   3. Execute os testes de unidade para garantir que a biblioteca esteja funcionando corretamente:

      nox
      

   4. Opcional: os testes de unidade também podem ser executados usando o Docker. Primeiro, você deve ter o Docker instalado (em inglês). Depois, da google-ads-python, execute o seguinte comando:

      docker build -t google-ads-python:test .
      docker run -it google-ads-python:test nox