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 tua 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'utilizzo.
Assicurati che nel tuo ambiente sia presente
python3.8o una versione successiva. Il modo più semplice è utilizzarepyenv:pyenv local 3.8Clona la libreria client da GitHub:
git clone git@github.com:googleads/google-ads-python.gitAccedi al 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 eventuali modifiche:
Assicurati che nel tuo ambiente siano disponibili tutte le versioni supportate del linguaggio Python. Utilizzo di
pyenv:pyenv local 3.8 3.9 3.10 3.11 3.12Installa le dipendenze specifiche per il 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 avere installato Docker. Quindi, dalla directory
google-ads-python, esegui questo comando:docker build -t google-ads-python:test . docker run -it google-ads-python:test nox