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à con il runtime e le 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 "feature" o "prerelease".

Quando adottiamo nuove versioni del runtime di Python, ci proponiamo di 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 delle dipendenze e delle piattaforme di runtime Python supportate, consulta la pagina Dipendenze.

Installazione

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

Configurazione

Una volta installata la libreria, dovrai configurarla. Esistono diversi modi per configurare la libreria, descritti nella nostra documentazione relativa alla 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, che sono documentati nell'elenco di seguito. Per informazioni dettagliate sulle differenze tra i flussi e per decidere quale sia il migliore per la tua applicazione, consulta la nostra documentazione su OAuth.

Eseguire una richiesta API

Dopo aver incorporato i token OAuth2 nella configurazione, puoi effettuare 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 il seguente 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: