إعداد مكتبة برامج Python

تثبيت مكتبة عملاء Python

لتثبيت مكتبة عملاء Python في بيئتك المحلية:

  1. استخرِج tarball مكتبة عملاء Python.

  2. نفِّذ الأمر التالي في الدليل نفسه:

    python -m pip install .

  3. اتبع التعليمات التي تظهر في الوحدة الطرفية لإكمال عملية التثبيت.

الإعداد باستخدام ملف YAML

يمكنك تحديد ملف YAML لاستخدامه عند إعداد العميل الذي يحتوي على معلومات المصادقة اللازمة اللازمة لإجراء الطلبات. يتم الوصول إلى هذا الملف عند إعداد برنامج باستخدام طريقة load_from_file. اتبع المثال الموضح أدناه عند إنشاء ملف YAML لتحديد الرمز المميّز للتحديث ومعرّف العميل وسر العميل.

لتحديد مكان ملف search-ads-360.yaml، يمكنك تمرير المسار كسلسلة إلى الطريقة عند استدعائه:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

إذا لم توفّر مسارًا، ستبحث المكتبة في دليل $HOME عن الملف:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

حقول الإعدادات

يتوافق إعداد مكتبة العملاء مع الحقول التالية.

الحقول العامة:

  • refresh_token: الرمز المميّز لإعادة تحميل OAuth
  • client_id: معرِّف عميل OAuth
  • client_secret: سر عميل OAuth.
  • login_customer_id: اطّلِع على مستنداتlogin-customer-id.

المفاتيح المتوافقة لتدفقات تطبيقات الويب وأجهزة الكمبيوتر المكتبي

إذا كنت تستخدم مسار تطبيق سطح المكتب أو الويب، تكون المفاتيح المتوافقة كما يلي:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE