La libreria client Python è ospitata su GitHub e il pacchetto è disponibile su PyPI.
Requisiti
La libreria supporta Python 3.9-3.14 (>=3.9, <3.15; il supporto di Python 3.14
è stato aggiunto in v28.2.0). Poiché Python 3.9 e 3.10 emettono un avviso
di ritiro all'importazione in google-ads v32.0.0 e versioni successive, è consigliabile utilizzare Python 3.11 o
versioni successive.
Prerequisiti
Prima di procedere con questa guida, devi disporre dell'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 stato "funzionalità" o "pre-release".
Il team dell'API Google Ads mira ad adottare le 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 dopo la data EOL nella sezione Versioni non supportate 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 elencati come richiesti dalla libreria client Python), la compatibilità viene mantenuta con i pacchetti gestiti da Google e considerati "supportati" in base alle Norme di Google sulle modifiche che causano interruzioni dell'OSS.
Per un elenco completo dei runtime Python e delle dipendenze 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 è con 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
Una volta scelto un approccio di configurazione, configura l'autenticazione. Per istruzioni passo passo, consulta la guida all'autenticazione della libreria client Python. Per informazioni di base più generali, consulta la panoramica di OAuth.
Eseguire una richiesta API
Una volta configurata l'autenticazione, puoi effettuare una richiesta API. Consulta l'esempio get campaigns per un modo rapido per verificare che la libreria sia configurata correttamente per effettuare richieste API.
Per eseguire l'esempio get_campaigns.py, clona prima il
repository google-ads-python. Quindi, dalla directory principale del repository clonato, esegui questo comando:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Risorse aggiuntive
Dopo aver inviato una richiesta API, procedi con questi utilizzi della libreria client: