دليل البدء السريع لاستخدام Merchant API

توضّح هذه الصفحة كيفية إنشاء حساب على Merchant Center وتحميل عيّنة منتج باستخدام Merchant API.

قبل البدء

فعِّل Merchant API في مشروعك على Google Cloud. ستحتاج إليه للمصادقة.

هل لديّ مشروع على Google Cloud؟

إذا كنت تستخدم عملية دمج واجهة برمجة التطبيقات في Apps Script باستخدام خدمة Shopping Content Service، سيتم إنشاء مشروع تلقائي على Google Cloud وتفعيل خدمة Merchant API تلقائيًا. ومع ذلك، لا يزال عليك إكمال عملية تسجيل المطوّر لمرة واحدة قبل استخدام Merchant API. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام خدمة Merchant API في Apps Script.

إذا لم يكن لديك مشروع على Google Cloud، يمكنك إنشاء مشروع على Google Cloud.

الانتقال إلى Google Cloud

الخطوة 1: إنشاء حساب في Merchant Center

لاستخدام Merchant API، يجب أن يكون لديك حساب على Merchant Center. لإنشاء حساب، يُرجى الاطّلاع على بدء استخدام Merchant Center. إذا كان لديك حساب على Merchant Center مع حقوق "المشرف"، يمكنك استخدامه.

الانتقال إلى Merchant Center

الخطوة 2: إعداد المصادقة لواجهة Merchant API

تعتمد أفضل طريقة لإعداد المصادقة على البيئة التي تخطّط للعمل فيها:

  • إذا كنت مقدّم خدمة تابعًا لجهة خارجية، اطلب من تطبيقك الحصول على إذن الوصول إلى حسابات عملائك على Merchant Center باستخدام OAuth 2.0. لمعرفة التفاصيل، يُرجى الاطّلاع على الوصول إلى حسابات العملاء. للتسجيل، عليك الحصول على رمز مميّز OAuth لحسابك على Google.
  • إذا كنت بصدد تطوير تطبيق داخلي يحتاج إلى الوصول إلى حسابك على Merchant Center فقط، يُرجى الاطّلاع على الوصول إلى حسابك بدلاً من ذلك.

الخطوة 3: تحديد طريقة التفاعل مع Merchant API

هناك طريقتان للتفاعل مع Merchant API:

طلبات البيانات المباشرة من واجهة برمجة التطبيقات

إرسال طلبات أولية إلى نقاط نهاية واجهة برمجة التطبيقات مباشرةً، عادةً عبر HTTP(S) يمكنك التعامل يدويًا مع إنشاء نص الطلب وتحديد العناوين (بما في ذلك المصادقة) وتحليل الاستجابة.

دليل طلبات البيانات المباشرة من واجهة برمجة التطبيقات

مكتبات العملاء

استخدِم مكتبات مُنشأة مسبقًا تتضمّن التفاصيل الأساسية لتقديم الطلبات والتعامل مع الردود. وهي تتعامل مع المصادقة وتسلسل الطلبات/الردود وغير ذلك من الرموز النموذجية.

دليل مكتبات العملاء