La libreria client Python è ospitata su GitHub, e il pacchetto è disponibile su PyPI.
Requisiti
La libreria richiede Python 3.9 o versioni successive.
Prerequisiti
Prima di procedere con questa guida, avrai bisogno di un token sviluppatore per l' API Google Ads e dell'ID cliente di 10 cifre per il 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 nostro obiettivo è 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. Non possiamo garantire la compatibilità con i runtime EOL, in quanto potremmo rilasciare una versione della libreria incompatibile con questi runtime in qualsiasi momento dopo la data di fine del ciclo di vita.
Per le dipendenze (in particolare, tutti i pacchetti gestiti da Google che sono elencati come richiesti dalla libreria client Python), manterremo la compatibilità con i pacchetti che sono gestiti da Google e considerati "supportati" in base alle Norme relative alle modifiche che causano interruzioni di Google OSS.
Per un elenco completo dei runtime e delle dipendenze Python supportati, consulta la pagina Dipendenze.
Installazione
La nostra guida all'installazione mostra 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
Una volta installata la libreria, dovrai configurarla. Esistono diversi modi per configurare la libreria, descritti nella nostra guida alla configurazione.
Autenticazione
Dopo aver scelto un approccio di configurazione, puoi configurare l'autenticazione. Per istruzioni passo passo, consulta la nostra guida alla configurazione dell'autenticazione della libreria client Python guide, e per informazioni di base più generali, consulta la nostra panoramica di OAuth.
Esegui una richiesta API
Una volta configurata 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 eseguire richieste API
Per eseguire l'esempio get_campaigns.py, nella directory principale della libreria client googleads-python installata localmente, esegui il seguente comando:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Risorse aggiuntive
Dopo aver eseguito una richiesta API, procedi con questi utilizzi della libreria client: