Python

توفّر Google مكتبة برامج Python للتفاعل مع واجهة برمجة تطبيقات "مدير الإعلانات". نوصي باستخدام مكتبة البرامج مع PyPI.

للبدء، يمكنك إنشاء مشروع جديد في بيئة تطوير متكاملة (IDE) من اختيارك أو إضافة والتبعية لمشروع موجود. تنشر Google عناصر مكتبة العميل على PyPI باسم google-ads-admanager.

pip install google-ads-admanager

ضبط بيانات الاعتماد

تستخدم مكتبة برامج Python بروتوكول OAuth2 وبيانات الاعتماد التلقائية للتطبيق. (ADC) للمصادقة.

يبحث ADC عن بيانات الاعتماد بالترتيب في المواقع التالية:

  1. متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS
  2. إعداد بيانات اعتماد المستخدم من خلال واجهة سطر الأوامر في Google Cloud (gcloud CLI).
  3. حساب الخدمة المرتبط بمورد Google Cloud عند تشغيله على Google Cloud

لإنشاء بيانات اعتماد ADC وتهيئتها، راجع المصادقة.

تقديم طلبك الأول

تحتوي كل خدمة على عنصر ServiceClient بكل من المزامنة المتزامنة وغير المتزامنة لكل طريقة REST. يقرأ المثال التالي Network بشكل متزامن.

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)
admanager_v1_generated_network_service_get_network_sync.py

للحصول على أمثلة حول طرق وموارد أخرى، يُرجى الاطّلاع على مستودع جيت هب googleapis/google-cloud-python

التعامل مع الأخطاء

تؤدي جميع أخطاء واجهة برمجة التطبيقات إلى توسيع الفئة الأساسية GoogleAPIError.

يحدد حقل سبب الخطأ أنواع الخطأ بشكل فريد. استخدام هذا الحقل لتحديد كيفية التعامل مع الخطأ.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

تتضمّن أخطاء واجهة برمجة تطبيقات "مدير الإعلانات" أيضًا requestId فريدًا يمكنك لتقديمها إلى فريق الدعم للحصول على مساعدة استكشاف الأخطاء وإصلاحها. يستخرج المثال التالي ملف requestId من GoogleAPIError؛

except GoogleAPIError as e:
  requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
  requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
  print(requestInfo['requestId'])

تهيئة إعدادات الخادم الوكيل

تلتزم مكتبة برامج Python بإعدادات متغيّرات البيئة للسمة http_proxy وhttps_proxy.