La libreria client Python è ospitata su GitHub e il pacchetto è disponibile su PyPI.
Requisiti
La libreria supporta Python da 3.9 a 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 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 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 in la 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 di fine del ciclo di vita 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 di fine del ciclo di vita potrebbero interrompere la compatibilità.
Per le dipendenze (in particolare, tutti i pacchetti gestiti da Google che sono elencati come richiesti dalla libreria client Python), la compatibilità viene mantenuta con i pacchetti gestiti da Google e considerati "supportati" ai sensi delle Norme relative alle modifiche che provocano un errore di 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 modi diversi 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
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 di base più generali, consulta la panoramica di OAuth.
Esegui una richiesta API
Dopo aver configurato l'autenticazione, puoi eseguire una richiesta API. Consulta l'esempio di recupero delle campagne per un modo rapido per verificare che la libreria sia configurata correttamente per effettuare richieste API.
Per eseguire l'get_campaigns.py esempio, clona prima il
google-ads-python repository. Poi, dalla directory principale del repository clonato, esegui il comando seguente:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Risorse aggiuntive
Dopo aver eseguito una richiesta API, procedi con questi utilizzi della libreria client: