أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

تثبيت مكتبة برامج 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: سر عميل 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