Installazione

Indipendentemente dal fatto che tu stia installando la libreria da PyPI o la stia clonando da GitHub, ti consigliamo di svolgere 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 è 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 sviluppare la libreria stessa. Come 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 python3.8 o una versione successiva. Il modo più semplice è utilizzare pyenv:

   pyenv local 3.8

2. Clona la libreria client da GitHub:

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

3. Accedi al repository e installalo:

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

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

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

      pyenv local 3.8 3.9 3.10 3.11 3.12

   2. Installa le dipendenze specifiche del test della libreria:

      python -m pip install .[tests]

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

      nox

   4. (Facoltativo) I test di unità possono essere eseguiti anche utilizzando Docker. Innanzitutto, devi avere 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