Instalação

Se você estiver instalando a biblioteca do PyPI ou clonando-a do GitHub, recomendamos que siga as etapas abaixo usando um ambiente virtual ativo. Para informações sobre como criar e ativar um ambiente virtual, consulte a documentação Ambiente virtual.

Instalar o módulo do PyPI

A biblioteca é distribuída no PyPI e pode ser instalada usando o 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 para sua máquina local. É útil clonar o código-fonte para executar facilmente os exemplos ou desenvolver a biblioteca. Para referência, executar um dos exemplos de autenticação é uma etapa obrigatória para configurar a biblioteca para uso.

1. Verifique se o python3.8 ou uma versão mais recente está presente no 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. Entre no 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 de fazer qualquer alteração:

   1. Verifique se todas as versões com suporte do idioma Python estão disponíveis no seu ambiente. Como usar 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ê precisa ter o Docker instalado. Em seguida, no diretório google-ads-python, execute o seguinte:

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