La libreria client Python è ospitata su GitHub e il pacchetto è disponibile su PyPI.
Requisiti
La libreria supporta Python dalla versione 3.9 alla 3.14 (>=3.9, <3.15; il supporto di Python 3.14 è stato aggiunto nella versione v28.2.0). Poiché Python 3.9 e 3.10 generano un avviso di ritiro durante l'importazione nella versione google-ads v32.0.0 e successive, è consigliabile utilizzare Python 3.11 o versioni successive.
Prerequisiti
Prima di procedere con questa guida, devi avere l'ID cliente a 10 cifre del tuo account Google Ads.
Compatibilità di runtime e dipendenze
La libreria client Python mantiene la compatibilità con i runtime Python nella sezione Versioni supportate pubblicata dalla Python Software Foundation, ad eccezione delle versioni con lo stato "funzionalità" o "anteprima".
Il team dell'API Google Ads mira ad adottare nuove versioni del runtime Python non appena vengono rilasciate e supportate ufficialmente dalla Python Software Foundation.
I runtime Python che hanno raggiunto la fine del ciclo di vita (EOL) non sono supportati oltre la data di fine del ciclo di vita nella sezione Unsupported Versions di python.org. La compatibilità con i runtime EOL non può essere garantita, poiché le release della libreria successive a una data EOL potrebbero interrompere la compatibilità.
Per le dipendenze (in particolare, tutti i pacchetti gestiti da Google che sono elencati come obbligatori dalla libreria client Python), la compatibilità viene mantenuta con i pacchetti gestiti da Google e considerati "supportati" in base alle norme relative alle modifiche che provocano un errore OSS di Google.
Per un elenco completo dei runtime e delle dipendenze Python supportati, consulta la pagina Dipendenze.
Installazione
La guida all'installazione descrive tutti i diversi modi per installare la libreria. Il modo più semplice (e consigliato) per installare la libreria
nella tua applicazione è utilizzare pip:
python -m pip install google-ads
Configurazione
Dopo aver installato la libreria, devi configurarla. Esistono diversi modi per configurare la libreria, descritti nella guida alla configurazione.
Autenticazione
Dopo aver scelto un approccio di configurazione, configura l'autenticazione. Per istruzioni passo passo, consulta la guida all'autenticazione della libreria client Python. Per informazioni più generali, consulta la panoramica di OAuth.
Effettua una richiesta API
Una volta impostata la configurazione di autenticazione, puoi effettuare una richiesta API. Consulta l'esempio Recupera campagne per un modo rapido per verificare che la libreria sia configurata correttamente per effettuare richieste API.
Per eseguire l'esempio get_campaigns.py, devi prima clonare il repository google-ads-python. Quindi, dalla directory root del repository clonato, esegui questo comando:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Risorse aggiuntive
Una volta che sei in grado di effettuare una richiesta API, procedi con questi utilizzi della libreria client: