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

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

إعداد مكتبة برامج 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