Installazione
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Che tu stia installando la libreria da PyPI o clonandola da GitHub, ti
consigliamo di eseguire i passaggi riportati di seguito utilizzando un ambiente
virtuale attivo. Per informazioni su come creare e attivare un ambiente virtuale, consulta la documentazione relativa all'ambiente virtuale.
Installa il modulo da PyPI
La libreria viene distribuita su PyPI e può essere installata utilizzando pip con il seguente comando:
python -m pip install google-ads
Installa la libreria da GitHub
Il codice sorgente della libreria può essere clonato da GitHub
sulla tua macchina locale. È utile clonare il codice sorgente per eseguire facilmente
gli esempi o per sviluppare la libreria stessa. Per riferimento, l'esecuzione di uno degli esempi di autenticazione è un passaggio obbligatorio per configurare la libreria per l'uso.
Assicurati che nel tuo ambiente sia presente python3.8 o versioni successive.
Il modo più semplice è utilizzare pyenv:
pyenv local 3.8
Clona la libreria client da GitHub:
git clone git@github.com:googleads/google-ads-python.git
Inserisci il repository e installalo:
cd google-ads-python
python -m pip install .
Se intendi sviluppare la libreria, esegui i test unitari prima e dopo
aver apportato modifiche:
Assicurati di avere a disposizione tutte le versioni supportate del linguaggio Python nel tuo ambiente. Utilizzo di pyenv:
pyenv local 3.8 3.9 3.10 3.11 3.12
Installa le dipendenze specifiche per i test della libreria:
python -m pip install .[tests]
Esegui i test delle unità per assicurarti che la libreria funzioni correttamente:
nox
(Facoltativo) I test delle unità possono essere eseguiti anche utilizzando Docker. Innanzitutto, devi
aver installato Docker. Quindi, dalla directory google-ads-python, esegui quanto segue:
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-27 UTC.
[null,null,["Ultimo aggiornamento 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"]]
