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

تثبيت مكتبة برامج Python

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

  1. استخرِج حِزمة tar الخاصة بمكتبة برامج 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