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

ننصح باستخدام مكتبات برامج واجهة Google API لإعدادها Content API for Shopping. يستخدم هذا الدليل عميل Python Content 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- sample/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 مستودع GitHub إلى أي مكان على جهاز الكمبيوتر؛ لا يلزم أن تكون في الدليل الرئيسي أو في ~/shopping-samples/content/.

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

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

   pip install -r requirements.txt
   

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