Installazione

Sia che tu stia installando la libreria da PyPI o la stia clonando da GitHub, esegui i seguenti passaggi utilizzando un ambiente virtuale attivo. Per informazioni su come creare e attivare un ambiente virtuale, consulta la documentazione relativa all'ambiente virtuale.

Per creare e attivare rapidamente un ambiente virtuale:

python3 -m venv env
source env/bin/activate

Installa il modulo da PyPI

La libreria è distribuita su PyPI e può essere installata utilizzando pip con il seguente comando:

python -m pip install google-ads

Verifica installazione

Verifica che il modulo sia stato installato correttamente:

python -c "import google.ads.googleads"

Installa la libreria da GitHub

Il codice sorgente della libreria può essere clonato da GitHub sulla tua macchina locale. La clonazione del codice sorgente è utile per eseguire 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'utilizzo.

  1. Assicurati che nel tuo ambiente sia presente una versione di Python supportata (Python dalla 3.9 alla 3.14; è consigliato Python 3.11 o versioni successive). Il modo più semplice è utilizzare pyenv:

    pyenv install 3.13
pyenv local 3.13

  2. Clona la libreria client da GitHub:

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

  3. Accedi al repository e installalo in modalità modificabile:

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

  4. Se intendi sviluppare la libreria, esegui i test delle unità prima e dopo aver apportato modifiche:

    1. Assicurati di avere tutte le versioni supportate del linguaggio Python disponibili nel tuo ambiente utilizzando pyenv:

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

    2. Installa le dipendenze della libreria specifiche per i test:

      python -m pip install -e ".[tests]"

    3. Esegui i test delle unità per assicurarti che la libreria funzioni correttamente:

      nox

    4. (Facoltativo) Puoi anche eseguire i test delle unità utilizzando Docker. Innanzitutto, assicurati di avere Docker installato. Quindi, dalla directory google-ads-python, esegui questi comandi:

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