Python

گوگل یک کتابخانه کلاینت پایتون را برای تعامل با Ad Manager API فراهم می کند. توصیه می کنیم از کتابخانه مشتری با PyPI استفاده کنید.

برای شروع، یک پروژه جدید در IDE مورد نظر خود ایجاد کنید یا وابستگی را به پروژه موجود اضافه کنید. Google مصنوعات کتابخانه مشتری را به عنوان google-ads-admanager در PyPI منتشر می کند.

pip install google-ads-admanager

اعتبارنامه ها را پیکربندی کنید

کتابخانه کلاینت پایتون از OAuth2 و اعتبارنامه های پیش فرض برنامه (ADC) برای احراز هویت استفاده می کند.

ADC اعتبارنامه ها را به ترتیب در مکان های زیر جستجو می کند:

متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS .
اطلاعات کاربری کاربر از طریق Google Cloud CLI (gcloud CLI) تنظیم شده است.
هنگام اجرا در 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

برای نمونه‌هایی از روش‌ها و منابع دیگر، به مخزن GitHub googleapis/google-cloud-python مراجعه کنید.

رسیدگی به خطاها

همه خطاهای API کلاس پایه GoogleAPIError را گسترش می دهند.

فیلد دلیل خطا به طور منحصر به فرد انواع خطا را شناسایی می کند. از این فیلد برای تعیین نحوه رسیدگی به خطا استفاده کنید.

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

خطاهای Ad Manager API همچنین شامل یک 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'])

تنظیمات پروکسی را پیکربندی کنید

کتابخانه کلاینت پایتون به تنظیمات متغیر محیطی http_proxy و https_proxy احترام می گذارد.

pip install google-ads-admanager