Completamento del codice IDE

Gli IDE come VS Code e PyCharm offrono il completamento del codice integrato per il linguaggio Python.

La libreria google-ads-python genera dinamicamente classi di messaggi protobuf in fase di runtime utilizzando i metodi getter nella classe GoogleAdsClient, che possono inibire le funzionalità di completamento del codice dell'IDE che si basano sull'analisi statica del codice sorgente.

Per migliorare la compatibilità con gli strumenti di completamento del codice che si basano sull'analisi statica, puoi:

  1. Utilizza le annotazioni dei tipi con i metodi getter dinamici (consigliato).
  2. Importa direttamente le classi di messaggi protobuf e i client di servizio.

Importazioni dinamiche con suggerimenti sui tipi

L'utilizzo di importazioni dinamiche garantisce che il codice rimanga resiliente durante gli aggiornamenti della libreria. L'aggiunta di annotazioni dei tipi consente il completamento del codice IDE senza perdere i vantaggi dell'inizializzazione dinamica:

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.v26.resources.types.campaign import (
    Campaign,
)

client = GoogleAdsClient.load_from_storage()

# Type hints allow the IDE to provide code completion suggestions while
# retaining dynamic class generation.
campaign: Campaign = client.get_type("Campaign")

Importazioni dirette

Puoi anche importare direttamente le classi di messaggi protobuf. Questo approccio consente il completamento del codice dell'IDE in modo immediato, senza utilizzare i metodi getter:

from google.ads.googleads.v26.resources import Campaign

# The Campaign class is imported directly, enabling the IDE to read the
# class definition and make code completion suggestions.
campaign = Campaign()

Svantaggi delle importazioni dirette

Sebbene l'importazione diretta delle classi generate aiuti con il completamento del codice, introduce anche alcuni compromessi:

  1. Più difficile da individuare: non è sempre ovvio in quale modulo si trovi una determinata classe, quindi trovare il percorso di importazione corretto può essere difficile.
  2. Fragilità tra gli upgrade: la struttura delle directory delle classi generate può cambiare con le nuove versioni della libreria client. Se importi le classi direttamente, il codice potrebbe non funzionare più quando esegui l'upgrade, mentre il codice che utilizza i metodi getter non è interessato da questi tipi di modifiche.
  3. Inizializzazione manuale richiesta: il metodo get_service inizializza i servizi con autenticazione, impostazioni di trasporto e intercettatori gRPC (che collegano intestazioni come login-customer-id e linked-customer-id, gestiscono il logging e aggregano gli errori in GoogleAdsException) prima di restituirli. Se importi e crei istanze dei servizi direttamente, questi intercettatori vengono ignorati e devi configurare manualmente le credenziali e i canali di trasporto:

    from google.ads.googleads.v26.services.services import (
        campaign_service as campaign_service_module,
    )
    
    # Dynamic service getter (initializes credentials, transport, and gRPC
    # interceptors automatically).
    campaign_service = client.get_service("CampaignService")
    
    # Direct service client import (requires manual credential and interceptor
    # configuration).
    campaign_service_client = campaign_service_module.CampaignServiceClient(
        credentials=client.credentials,
    )