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

نودّ إطلاعك على الإصدار التجريبي من Merchant API. إنه الإصدار الجديد من Content API والمستقبل.

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

ملاحظة: عليك تثبيت العديد من المكتبات المطلوبة لاستخدام نموذج الرمز في بايثون. لهذا السبب، نوصي بإنشاء بيئة بايثون افتراضية قبل المتابعة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تثبيت الحِزم باستخدام بروتوكول pip والبيئات الافتراضية.

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

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

   ~/shopping-samples/content/

   ملاحظة: يتم تحديد هذا المسار، بالإضافة إلى اسم الملف للملف merchant-info.json الذي تم إنشاؤه في الخطوة 5، في ملف python/shopping/content/common.py ضمن دليل نماذج Content API الذي تم تنزيله في الخطوة 7.

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

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

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

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

   ملاحظة: يتم تحديد اسم الملف هذا في ملف _constants.py الموجود في python/shopping/content/ ضمن دليل نماذج Content API الذي تم تنزيله في الخطوة 7.

4. انقل ملف service-account.json إلى home directory/shopping- sample/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- sample مستودع GitHub من أي موقع على جهاز الكمبيوتر، وليس من الضروري أن يكون في الدليل الرئيسي أو في ~/shopping-samples/content/.

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

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

   pip install -r requirements.txt
   

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