تثبيت مكتبة برامج Python
لتثبيت مكتبة برامج Python في بيئتك المحلية، اتّبِع الخطوات التالية:
- استخرِج tarball من مكتبة عملاء Python.
شغِّل الأمر التالي في الدليل نفسه:
python -m pip install .
اتّبِع التعليمات الواردة في الوحدة الطرفية لإكمال عملية التثبيت.
الإعداد باستخدام ملف 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
: سر عميل OAuthlogin_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