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

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

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

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

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

   ~/shopping-samples/content/

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

2. لتنزيل بيانات اعتماد حساب الخدمة، يُرجى اتّباع الخطوات التالية:

   1. انتقِل إلى مكتبة Google API.
   2. اختَر مشروعًا في القائمة أعلى الصفحة. إذا لم يكن لديك مشروع بعد، أنشئ مشروعًا من خلال النقر على مشروع جديد.
   3. إذا لم يسبق لك تفعيل Content API for Shopping لهذا المشروع، ابحث عنه في قائمة Google APIs وفعِّله.
   4. انقر على قائمة التنقّل (☰) في أعلى يمين الصفحة، ثم انقر على واجهات برمجة التطبيقات والخدمات ، ثم على بيانات الاعتماد.
   5. لإعداد حساب خدمة، انقر على إنشاء بيانات اعتماد، ثم على حساب الخدمة.
   6. أدخِل اسم حساب الخدمة الجديد. يُستخدَم هذا الاسم أيضًا كاسم مستخدم تلقائي لمعرّف حساب الخدمة. سجِّل رقم تعريف حساب الخدمة، بما في ذلك الجزء الذي يلي الرمز "@"، لاستخدامه لاحقًا. انقر على إنشاء، ثم اتّبِع الخطوات الاختيارية لمنح إذن الوصول إلى المشروع والمستخدمين، وانقر على تم.
   7. سيتم توجيهك إلى صفحة "حسابات الخدمة" حيث يمكنك الوصول إلى حساب الخدمة الجديد.

3. للحصول على مفتاح خاص بتنسيق JSON، انقر على حساب الخدمة، ثم على علامة التبويب المفاتيح. انقر على إضافة مفتاح > إنشاء مفتاح جديد، ثم اختَر JSON كنوع المفتاح. انقر على إنشاء لتنزيل المفتاح الخاص على جهاز الكمبيوتر. يتم تنزيل المفتاح الجديد تلقائيًا.

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

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

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

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

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

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

8. أضِف حساب الخدمة الجديد كمستخدم إلى حسابك على Merchant Center. إذا كنت مطوّرًا خارجيًا، عليك أن تطلب من عميلك تنفيذ هذه الخطوة نيابةً عنك.

   1. انتقِل إلى حسابك على Merchant Center.
   2. في إعدادات حسابك على Merchant Center، انقر على المستخدمون وإمكانية الوصول.

   3. انقر على ‎+ إضافة مستخدم واستخدِم رقم تعريف حساب الخدمة كعنوان البريد الإلكتروني للمستخدم الجديد.

      **ملاحظة:** إذا لم تسجِّل رقم تعريف حساب الخدمة سابقًا، انتقِل إلى صفحة إدارة "حسابات الخدمة" واختَر المشروع الذي أنشأته.

   4. يتطلّب استخدام خدمة Accounts إذن وصول المشرف، لذا انقر على المشرف.

   5. انقر على إضافة مستخدم لحفظ الإعدادات المفضّلة والعودة إلى قائمة المستخدمين. يظهر رقم تعريف حساب الخدمة مع دور المستخدم الذي تم اختياره.

   6. كرِّر العملية لجميع حسابات الخدمة الأخرى التي تريد إضافتها.

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

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

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

    pip install -r requirements.txt
    

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