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 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 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 in qualsiasi momento dopo la data EOL.
Per le dipendenze (in particolare, per tutti i pacchetti gestiti da Google elencati come richiesti dalla libreria client Python), manterremo la compatibilità con i pacchetti gestiti da Google e considerati "supportati" in base alle Norme relative alle modifiche che causano interruzioni dell'OSS di Google.
Per un elenco completo dei runtime Python e delle dipendenze supportati, consulta la pagina Dipendenze.
Installazione
La nostra guida all'installazione mostra 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
Una volta installata la libreria, dovrai configurarla. Esistono diversi modi per configurare la libreria, descritti nella nostra guida alla configurazione.
Autenticazione
Una volta scelto un approccio di configurazione, puoi configurare l'autenticazione. Per istruzioni passo passo, consulta la nostra guida all'autenticazione della libreria client Python e per informazioni di base più generali consulta la nostra panoramica di OAuth.
Esegui una richiesta API
Una volta configurata l'autenticazione, puoi effettuare 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'esempio get_campaigns.py, nella directory principale della libreria client googleads-python installata localmente, esegui questo comando:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Risorse aggiuntive
Dopo aver effettuato una richiesta API, procedi con questi utilizzi della libreria client: