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 sull'ambiente virtuale.
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
Installa la libreria da GitHub
Il codice sorgente della libreria può essere clonato da GitHub sulla macchina locale. È utile clonare il codice sorgente per eseguire facilmente gli esempi o per sviluppare la libreria stessa. Come riferimento, l'esecuzione di uno degli esempi di autenticazione è un passaggio obbligatorio per la configurazione della libreria per l'uso.
Assicurati che nel tuo ambiente sia presente
python3.8
o una versione successiva. Il modo più semplice è utilizzarepyenv
: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 delle unità prima e dopo aver apportato modifiche:
Assicurati di avere a disposizione nel tuo ambiente tutte le versioni supportate del linguaggio Python. Utilizzo di
pyenv
:pyenv local 3.8 3.9 3.10 3.11 3.12
Installa le dipendenze della libreria specifiche per il test:
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 avere Docker installato. Quindi, dalla directory
google-ads-python
, esegui questo comando:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox