Panoramica

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, devi disporre di un token sviluppatore e dell'ID cliente del client. 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 in il Versioni supportate pubblicata dal Python Software Foundation, ad eccezione di versioni con stato "feature" o "pre-release".

Quando adottiamo nuove versioni del runtime di Python, ci impegniamo a rilasciare una nuova versione della libreria client Python compatibile con il runtime più recente entro la fine del trimestre successivo al rilascio. Ad esempio, se a ottobre viene rilasciato un nuovo runtime, entro la fine di marzo dell'anno successivo sarà disponibile una versione compatibile della libreria client Python.

I runtime di Python che hanno raggiunto la fine del ciclo di vita (EOL) non sono supportati dopo la data di fine del ciclo di vita riportata nella sezione Versioni non supportate di python.org.

Potremmo rilasciare una versione della libreria client Python incompatibile con i runtime Python non supportati in qualsiasi momento dopo il raggiungimento del ciclo di vita.

Per le dipendenze (in particolare, tutti i pacchetti gestiti da Google che sono elencati come obbligatori 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 comportano interruzioni per il software open source di Google.

Per un elenco completo dei runtime e delle dipendenze Python supportati, consulta Dipendenze.

Installazione

Segui le istruzioni riportate nella nostra installazione documentazione per installare la libreria da PyPi e tornare a questa pagina.

Configurazione

Una volta installata la libreria, dovrai impostare una configurazione per li annotino. Esistono diversi modi per configurare la libreria, descritti nei nostri documentazione di configurazione.

Autenticazione

Una volta scelto un tipo di configurazione, puoi procedere con la generazione degli altri token OAuth2 necessari per effettuare richieste all'API. Esistono piùflussi OAuth2 supportati, descritti nell'elenco di seguito. Per maggiori dettagli su le differenze tra i flussi e aiutare a decidere quale sia la più adatta consulta la nostra documentazione relativa a OAuth.

Invio di una richiesta API

Dopo aver incorporato i token OAuth2 nella configurazione, puoi effettuare una richiesta API. Consulta le esempio di get campaigns per un modo semplice per verificare che la libreria sia configurata correttamente per rendere l'API richieste.

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

Quando puoi effettuare una richiesta API, procedi con questi utilizzi del client libreria: