Penyelesaian kode IDE

IDE seperti VS Code dan PyCharm menawarkan penyelesaian kode bawaan untuk bahasa Python.

Library google-ads-python menghasilkan class pesan protobuf secara dinamis saat runtime menggunakan metode pengambil di class GoogleAdsClient, yang dapat menghambat fitur penyelesaian kode IDE yang mengandalkan analisis statis kode sumber.

Untuk meningkatkan kompatibilitas dengan alat penyelesaian kode yang mengandalkan analisis statis, Anda dapat:

  1. Gunakan anotasi jenis dengan metode pengambil dinamis (direkomendasikan).
  2. Impor class pesan protobuf dan klien layanan secara langsung.

Impor dinamis dengan petunjuk jenis

Menggunakan impor dinamis akan memastikan kode Anda tetap tangguh di seluruh update library. Menambahkan anotasi jenis memungkinkan penyelesaian kode IDE tanpa kehilangan manfaat inisialisasi dinamis:

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")

Impor langsung

Anda juga dapat mengimpor class pesan protobuf secara langsung. Pendekatan ini memungkinkan pelengkapan kode IDE secara langsung, tanpa menggunakan metode pengambil:

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()

Kekurangan impor langsung

Meskipun mengimpor class yang dihasilkan secara langsung membantu penyelesaian kode, hal ini juga memiliki beberapa konsekuensi:

  1. Lebih sulit ditemukan: Tidak selalu jelas di modul mana class tertentu berada, sehingga menemukan jalur impor yang benar bisa jadi sulit.
  2. Rapuh saat diupgrade: Struktur direktori class yang dihasilkan dapat berubah seiring dengan versi baru library klien. Jika Anda mengimpor class secara langsung, kode Anda mungkin rusak saat Anda mengupgrade, sedangkan kode yang menggunakan metode pengambil tidak terpengaruh oleh jenis perubahan ini.
  3. Inisialisasi manual diperlukan: Metode get_service menginisialisasi layanan dengan autentikasi, setelan transpor, dan interceptor gRPC (yang melampirkan header seperti login-customer-id dan linked-customer-id, menangani logging, dan menggabungkan error dalam GoogleAdsException) sebelum menampilkannya. Jika Anda mengimpor dan membuat instance layanan secara langsung, interceptor tersebut akan diabaikan dan Anda harus mengonfigurasi kredensial dan saluran transportasi secara manual:

    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,
    )