إعداد مكتبة عميل

ونوصي باستخدام مكتبات عميل Google API لإعداد Content API for Shopping. يستخدم هذا الدليل مكتبات برامج Python Content API كمثال، ولكنها متاحة للعديد من لغات البرمجة الشائعة وتبسيط مهام API الشائعة مثل المصادقة وإرسال الطلبات وتحليل الردود. للحصول على مساعدة في إعداد مكتبات العملاء للغات أخرى، اطّلع على README.md للغة في تقرير googleads/googleads-shopping-samples على GitHub.

لإعداد مكتبة برامج Google API للغة Python، أكمل الخطوات التالية:

1. أنشئ دليلاً لملفات تهيئة ومصادقة مكتبة العميل. في الدليل الرئيسي، أنشئ الأدلة التالية:

   ~/shopping-samples/content/

2. لتنزيل بيانات اعتماد حساب الخدمة، أكمل الخطوات التالية:

   1. في Merchant Center، في قائمة الإعدادات، اختَر Content API.
   2. انقر على مصادقة.
   3. انقر على [+] إنشاء مفتاح واجهة برمجة التطبيقات.
   4. اقرأ بنود اتفاقيات الخدمة ووافق عليها، إذا طُلب منك ذلك.

   يتم تنزيل المفتاح الجديد تلقائيًا.

3. أعد تسمية ملف بيانات الاعتماد الذي تم تنزيله إلى service-account.json.

4. انقُل ملف service-account.json إلى home directory/shopping-samples/content/.

5. في ملف home directory/shopping-samples/content/، أنشِئ ملفًا فارغًا من ملف merchant-info.json.

6. في merchant-info.json، أضِف النص التالي:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

7. استنساخ (أو تنزيل وفك ضغط) googleads/googleads-shopping-samples repo GitHub لأي موقع على جهاز الكمبيوتر، ولا يشترط أن تكون في الدليل الرئيسي أو في ~/shopping-samples/content/.

8. وفي حالة تنزيل ملف repo وفك ضغطه، بدلاً من نسخه، أعد تسمية الدليل الذي تم فك ضغطه إلى googleads-shopping-samples.

9. لتثبيت نماذج التبعيات المطلوبة، في نافذة طرفية، انتقل إلى googleads-shopping-samples/python/ وشغّل:

   pip install -r requirements.txt
   

تم الآن إعداد مكتبة برامج "واجهة Google API" للغة Python وهي جاهزة للاستخدام مع Content API. في القسم التالي، ستنشئ طلبًا لإدخال منتج جديد وترسله.