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

ننصح باستخدام مكتبات برامج واجهة 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. انتقِل إلى مكتبة Google API.
   2. اختَر مشروعًا من القائمة في أعلى الصفحة. إذا لم يكن لديك حساب بعد ذلك، عليك إنشاء حساب بالنقر على مشروع جديد.
   3. في حال عدم تفعيل Content API for Shopping لهذا المنتج من قبل ثم البحث عنه في قائمة Google APIs وتفعيله.
   4. في الشريط الجانبي على يمين الصفحة، اختَر بيانات الاعتماد. قد تحتاج إلى النقر على السهم الذي يشير إلى اليسار في أعلى اليسار لمشاهدة ذلك.
   5. لإعداد حساب خدمة، اختَر إنشاء بيانات اعتماد، ثم حساب الخدمة:
   6. أدخِل اسمًا لحساب الخدمة الجديد. يعمل هذا أيضًا كاسم المستخدم الافتراضي رقم تعريف حساب الخدمة. سجِّل رقم تعريف حساب الخدمة، بما في ذلك الجزء. بعد العلامة "@" للاستخدام لاحقًا. انقر على إنشاء، ثم انتقِل إلى الخطوات الاختيارية لمنح حق الوصول إلى المشروع والمستخدمين، وانقر فوق تم.
   7. سيتم توجيهك إلى صفحة "حسابات الخدمة" حيث تظهر خدمتك الجديدة الدخول إلى الحساب.

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

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

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

6. في home directory/shopping- sample/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. في القسم التالي، ستنشئ طلبًا وترسله لإدراج منتج جديد.