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

إليك Merchant API (الإصدار التجريبي)، البديل الرسمي لواجهة برمجة التطبيقات Content API for Shopping.

الاطّلاع على أحدث الميزات الجديدة وإصلاحات الأخطاء وتعديلات الإصدار من Merchant API (الإصدار التجريبي)

تعرَّف على كيفية إدارة نشاطك التجاري ومنتجاتك على Google وكيفية الحصول على إذن بالوصول الآلي إلى البيانات والإحصاءات والإمكانات الفريدة على نطاق واسع. ابدأ الآن

ننصحك باستخدام مكتبات عملاء Google API لإعداد Content API for Shopping. يستخدِم هذا الدليل مكتبات Python Content API العميلة كمثال، ولكنّها متاحة للعديد من لغات البرمجة الشائعة وتبسِّط مهام واجهة برمجة التطبيقات الشائعة، مثل المصادقة وإرسال الطلبات وتحليل الردود. للحصول على مساعدة في إعداد مكتبات البرامج ل اللغات الأخرى، اطّلِع على 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 وفعِّلها.
   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. استنسِخ (أو نزِّل وفكِّ ضغط) مستودع GitHub googleads/googleads-shopping-samples إلى أيّ موقع على جهاز الكمبيوتر، ولا يلزم أن يكون في directory home أو في ~/shopping-samples/content/.

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

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

    pip install -r requirements.txt
    

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