IDE কোড সম্পূর্ণ করা

VS Code এবং PyCharm-এর মতো IDE, Python ল্যাঙ্গুয়েজের জন্য বিল্ট-ইন কোড সম্পূর্ণ করার সুবিধা অফার করে।

google-ads-python লাইব্রেরি রানটাইমে GoogleAdsClient ক্লাসে গেটার পদ্ধতি ব্যবহার করে ডায়নামিকভাবে প্রোটোবাফ মেসেজ ক্লাস তৈরি করে, যা সোর্স কোডের স্ট্যাটিক বিশ্লেষণের উপর নির্ভর করে IDE কোড সম্পূর্ণ করার ফিচারকে বাধা দিতে পারে।

স্ট্যাটিক বিশ্লেষণের উপর নির্ভর করে এমন কোড সম্পূর্ণ করার টুলের সাথে কম্প্যাটিবিলিটি উন্নত করতে, আপনি এগুলির মধ্যে যেকোনও একটি করতে পারেন:

  1. ডায়নামিক গেটার মেথড-এর সাথে টাইপ অ্যানোটেশন ব্যবহার করুন (সাজেস্ট করা হয়)।
  2. সরাসরি protobuf মেসেজ ক্লাস ও পরিষেবা ক্লায়েন্ট ইমপোর্ট করুন।

টাইপ হিন্ট সহ ডায়নামিক ইমপোর্ট

ডায়নামিক ইমপোর্ট ব্যবহার করলে, লাইব্রেরি আপডেট করা হলেও আপনার কোড কাজ করবে। টাইপ অ্যানোটেশন যোগ করলে, ডায়নামিক ইনিশিয়ালাইজেশনের সুবিধা না হারিয়েই IDE কোড সম্পূর্ণ করা যায়:

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

সরাসরি ইম্পোর্ট

এছাড়াও, আপনি সরাসরি protobuf মেসেজ ক্লাস ইমপোর্ট করতে পারবেন। এই পদ্ধতি গেটার মেথড ব্যবহার না করেই IDE কোড সম্পূর্ণ করার সুবিধা দেয়:

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

সরাসরি ইমপোর্ট করার অসুবিধা

জেনারেট করা ক্লাস সরাসরি ইমপোর্ট করলে কোড সম্পূর্ণ করতে সাহায্য হয়, তবে এর ফলে কিছু ট্রেড-অফও হয়:

  1. খুঁজে পাওয়া কঠিন: কোনও ক্লাস কোন মডিউলে আছে তা সবসময় বোঝা যায় না, তাই সঠিক ইমপোর্ট পাথ খুঁজে পাওয়া কঠিন হতে পারে।
  2. আপগ্রেড করার সময় ভঙ্গুর: জেনারেট করা ক্লাসের ডিরেক্টরি স্ট্রাকচার ক্লায়েন্ট লাইব্রেরির নতুন ভার্সনের সাথে পরিবর্তন হতে পারে। আপনি সরাসরি ক্লাস ইমপোর্ট করলে, আপগ্রেড করার সময় আপনার কোড ভেঙে যেতে পারে, তবে গেটার পদ্ধতি ব্যবহার করে এমন কোড এই ধরনের পরিবর্তনের ফলে প্রভাবিত হয় না।
  3. ম্যানুয়ালি শুরু করতে হবে: get_service পদ্ধতিটি যাচাইকরণ, ট্রান্সপোর্ট সেটিংস এবং gRPC ইন্টারসেপ্টর (যা login-customer-id এবং linked-customer-id-এর মতো হেডার অ্যাটাচ করে, লগিং ম্যানেজ করে এবং GoogleAdsException-এ ত্রুটিগুলি র‍্যাপ করে) সহ পরিষেবাগুলি ফেরত দেওয়ার আগে শুরু করে। আপনি যদি সরাসরি পরিষেবা ইমপোর্ট এবং ইনস্ট্যান্টিয়েট করেন, তাহলে সেই ইন্টারসেপ্টরগুলি বাইপাস করা হয় এবং আপনাকে অবশ্যই ম্যানুয়ালি ক্রেডেনশিয়াল এবং ট্রান্সপোর্ট চ্যানেল কনফিগার করতে হবে:

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