أصبحت 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