Środowiska IDE takie jak VS Code i PyCharm oferują wbudowane uzupełnianie kodu w języku Python.
Biblioteka google-ads-python generuje klasy wiadomości protobuf dynamicznie w czasie działania, używając metod getter w klasie GoogleAdsClient, co może uniemożliwiać działanie funkcji uzupełniania kodu w środowisku IDE, które opierają się na analizie statycznej kodu źródłowego.
Aby poprawić zgodność z narzędziami do uzupełniania kodu, które korzystają z analizy statycznej, możesz:
- Używaj adnotacji typu z dynamicznymi metodami pobierającymi (zalecane).
- Importuj klasy wiadomości protobuf i klientów usługi bezpośrednio.
Importy dynamiczne ze wskazówkami dotyczącymi typów
Dzięki dynamicznemu importowaniu kod pozostaje odporny na aktualizacje biblioteki. Dodanie adnotacji typu umożliwia uzupełnianie kodu w IDE bez utraty korzyści płynących z dynamicznej inicjalizacji:
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")
Importy bezpośrednie
Możesz też bezpośrednio importować klasy wiadomości protobuf. To podejście umożliwia uzupełnianie kodu w IDE bez używania metod 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()
Wady importu bezpośredniego
Bezpośrednie importowanie wygenerowanych klas pomaga w uzupełnianiu kodu, ale wiąże się też z pewnymi kompromisami:
- Trudniejsze do znalezienia: nie zawsze jest oczywiste, w którym module znajduje się dana klasa, więc znalezienie prawidłowej ścieżki importu może być trudne.
- Niestabilność podczas uaktualniania: struktura katalogów wygenerowanych klas może się zmieniać w nowych wersjach biblioteki klienta. Jeśli importujesz klasy bezpośrednio, kod może przestać działać po uaktualnieniu, podczas gdy kod, który używa metod pobierających, nie jest narażony na tego typu zmiany.
Wymagana jest ręczna inicjalizacja: metoda
get_serviceinicjuje usługi z uwierzytelnianiem, ustawieniami transportu i przechwytywaczami gRPC (które dołączają nagłówki takie jaklogin-customer-idilinked-customer-id, obsługują logowanie i opakowują błędy wGoogleAdsException), zanim je zwróci. Jeśli importujesz i tworzysz instancje usług bezpośrednio, te przechwytywacze są pomijane i musisz ręcznie skonfigurować dane logowania i kanały transportu: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, )