توفّر بيئات التطوير المتكاملة (IDE)، مثل VS Code وPyCharm، ميزة إكمال الرموز البرمجية المضمّنة للغة Python.
تُنشئ مكتبة google-ads-python فئات رسائل protobuf ديناميكيًا
أثناء التشغيل باستخدام طرق الحصول على البيانات في فئة GoogleAdsClient،
ما قد يمنع ميزات الإكمال التلقائي للرموز في بيئة التطوير المتكاملة (IDE) التي تعتمد على التحليل الثابت
للرمز المصدر.
لتحسين التوافق مع أدوات الإكمال التلقائي للرموز البرمجية التي تعتمد على التحليل الثابت، يمكنك إجراء أي مما يلي:
- استخدِم التعليقات التوضيحية للنوع مع طرق الحصول على البيانات الديناميكية (يُنصح بذلك).
- استيراد فئات رسائل 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()
عيوب عمليات الاستيراد المباشرة
على الرغم من أنّ استيراد الفئات التي تم إنشاؤها مباشرةً يساعد في إكمال الرموز البرمجية، إلا أنّه يؤدي أيضًا إلى بعض المفاضلات:
- صعوبة تحديد الموقع: ليس من السهل دائمًا معرفة الوحدة التي تنتمي إليها فئة معيّنة، لذا قد يكون من الصعب العثور على مسار الاستيراد الصحيح.
- هشاشة في الترقيات: يمكن أن تتغير بنية الدليل للفئات التي تم إنشاؤها مع الإصدارات الجديدة من مكتبة البرامج. إذا استوردت الفئات مباشرةً، قد يتعطّل الرمز البرمجي عند الترقية، في حين أنّ الرمز البرمجي الذي يستخدم طرق الحصول على البيانات لا يتأثر بهذه الأنواع من التغييرات.
يجب الإعداد يدويًا: تعمل طريقة
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, )