Instalação
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recomendamos que você siga as etapas abaixo usando um ambiente virtual ativo, seja instalando a biblioteca do PyPI ou clonando do GitHub. 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 própria biblioteca. Para referência, executar um dos exemplos de autenticação é uma etapa obrigatória na configuração da biblioteca para uso.
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
Clone a biblioteca de cliente do GitHub:
git clone git@github.com:googleads/google-ads-python.git
Insira e instale o repositório:
cd google-ads-python
python -m pip install .
Se você pretende desenvolver a biblioteca, execute os testes de unidade antes e depois
de fazer qualquer mudança:
Verifique se todas as versões compatíveis da linguagem Python estão disponíveis no seu ambiente. Usando pyenv:
pyenv local 3.8 3.9 3.10 3.11 3.12
Instale as dependências específicas de teste da biblioteca:
python -m pip install .[tests]
Execute os testes de unidade para garantir que a biblioteca esteja funcionando corretamente:
nox
Opcional: os testes de unidade também podem ser executados usando o Docker. Primeiro, você precisa
ter o Docker instalado (em inglês). 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
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-27 UTC.
[null,null,["Última atualização 2025-08-27 UTC."],[[["\u003cp\u003eThe Google Ads Python library can be installed from PyPI using pip with the command \u003ccode\u003epython -m pip install google-ads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo install from GitHub, clone the repository, navigate into it, and run \u003ccode\u003epython -m pip install .\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnsure you have Python 3.8 or later installed in your environment, potentially using pyenv.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should run unit tests before and after making changes, utilizing nox or Docker for execution.\u003c/p\u003e\n"],["\u003cp\u003eFor library setup and usage, refer to the Virtual Environment and authentication example documentation.\u003c/p\u003e\n"]]],[],null,["# Installation\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhether you're installing the library from PyPI or cloning it from GitHub, we\nrecommended that you conduct the below steps using an active virtual\nenvironment. For information on how to create and activate a virtual\nenvironment, see the [Virtual Environment](//docs.python.org/3/tutorial/venv.html) documentation.\n\nInstall the module from PyPI\n----------------------------\n\nThe library is distributed on [PyPI](//pypi.org/project/google-ads/) and can\nbe installed using [pip](//pip.pypa.io/en/stable/installing) with the\nfollowing command: \n\n python -m pip install google-ads\n\nInstall the library from GitHub\n-------------------------------\n\nThe source code for the library can be cloned from [GitHub](https://github.com/googleads/google-ads-python/)\nonto your local machine. It's useful to clone the source code in order to easily\nexecute the examples or to develop the library itself. For reference, running\none of the authentication examples is a required step in configuring the library\nfor use.\n\n1. Ensure that `python3.8` or later is present in your environment.\n The simplest way is to use [`pyenv`](//github.com/pyenv/pyenv-installer):\n\n pyenv local 3.8\n\n2. Clone the client library from GitHub:\n\n git clone git@github.com:googleads/google-ads-python.git\n\n3. Enter the repository and install it:\n\n cd google-ads-python\n python -m pip install .\n\n4. If you intend to develop the library, run the unit tests before and after\n making any changes:\n\n 1. Ensure you have all supported versions of the Python language available in\n your environment. Using `pyenv`::\n\n pyenv local 3.8 3.9 3.10 3.11 3.12\n\n 2. Install the test-specific dependencies of the library:\n\n python -m pip install .[tests]\n\n 3. Run the unit tests to ensure the library is functioning properly:\n\n nox\n\n 4. Optional: the unit tests can also be run using Docker. First, you must\n have [Docker installed](https://docs.docker.com/get-docker/). Then, from\n the `google-ads-python` directory, run the following:\n\n docker build -t google-ads-python:test .\n docker run -it google-ads-python:test nox"]]
