La libreria client Python è ospitata su GitHub e il pacchetto è disponibile su PyPI.
Requisiti
La libreria richiede Python 3.8 o versioni successive.
Prerequisiti
Prima di installare la libreria, avrai bisogno di un token sviluppatore e di un ID cliente. Le istruzioni su come ottenerli sono riportate nella sezione Prerequisiti. Tieni presente che genererai gli altri token OAuth2 richiesti nei passaggi successivi.
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".
Quando adottiamo nuove versioni del runtime Python, il nostro obiettivo è rilasciare una nuova versione della libreria client Python compatibile con l'ultimo runtime entro la fine del trimestre successivo al suo rilascio. Ad esempio, se a ottobre viene rilasciato un nuovo runtime, una versione compatibile della libreria client Python sarà disponibile entro la fine di marzo dell'anno successivo.
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.
Potremmo rilasciare una versione della libreria client Python incompatibile con runtime Python non supportati in qualsiasi momento dopo il raggiungimento della fine del ciclo di vita.
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 e delle dipendenze Python supportati, consulta la pagina Dipendenze.
Installazione
Segui le istruzioni riportate nella nostra documentazione sull'installazione per installare la libreria da PyPi e tornare a questa pagina.
Configurazione
Una volta installata la libreria, dovrai configurarla. Esistono diversi modi per configurare la libreria, descritti nella nostra documentazione di configurazione.
Autenticazione
Una volta scelto un tipo di configurazione, puoi procedere con la generazione dei token OAuth2 rimanenti necessari per effettuare richieste all'API. Esistono più flussi OAuth2 supportati, documentati nell'elenco seguente. Per informazioni dettagliate sulle differenze tra i flussi e per decidere quale sia il migliore per la tua applicazione, consulta la nostra documentazione OAuth.
Creazione di una richiesta API
Una volta incorporati i token OAuth2 nella configurazione, puoi inviare una richiesta API. Consulta l'esempio get campaigns per un modo semplice 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: