Installazione

Che tu stia installando la libreria da PyPI o clonandola da GitHub, ti consigliamo di eseguire i passaggi riportati di seguito utilizzando una macchina virtuale completamente gestito di Google Cloud. Per informazioni su come creare e attivare un'istanza consulta la documentazione sull'ambiente virtuale.

Installa il modulo da PyPI

La libreria è distribuita su PyPI e può deve essere installata utilizzando pip con 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 semplificare di eseguire gli esempi o di sviluppare la libreria stessa. Come riferimento, l'esecuzione uno degli esempi di autenticazione è un passaggio obbligatorio per la configurazione per l'uso.

  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. Inserisci il repository e installalo:

    cd google-ads-python
    python -m pip install .
    
  4. Se intendi sviluppare la libreria, esegui i test delle unità prima e dopo per apportare modifiche:

    1. Assicurati di avere a disposizione tutte le versioni supportate del linguaggio Python in del tuo ambiente. Utilizzo di pyenv:

      pyenv local 3.8 3.9 3.10 3.11 3.12
      
    2. Installa le dipendenze della libreria specifiche per il test:

      python -m pip install .[tests]
      
    3. Esegui i test delle unità per assicurarti che la libreria funzioni correttamente:

      nox
      
    4. (Facoltativo) I test delle unità possono essere eseguiti anche utilizzando Docker. Innanzitutto, devi Docker è installato. Poi, da nella directory google-ads-python, esegui questo comando:

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