Instalação

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

Instalar o módulo do PyPI

A biblioteca é distribuída no PyPI e pode ser instalada facilmente usando pip. Basta executar 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 executar facilmente os exemplos ou desenvolver a 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 há python3.6 ou mais no ambiente. A maneira mais simples é usar pyenv:

    pyenv global 3.6
    
  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 de fazer qualquer alteração:

    1. Verifique se você tem python3.6 e python3.7 disponíveis no seu ambiente. Usando pyenv, conforme mencionado acima:

      pyenv global 3.6 3.7
      
    2. Execute os testes de unidade para garantir que a biblioteca esteja funcionando corretamente:

      nox