البدء

تتيح واجهة برمجة تطبيقات Manufacturer Center (MfC) للتطبيقات التفاعل مباشرةً مع منصة Manufacturer Center. لمساعدتك في البدء، نقدّم عيّنات تعليمات برمجية في Java و .NET.

سيساعدك هذا الدليل في إنشاء أول تطبيق لك باستخدام واجهة برمجة تطبيقات Manufacturer Center. قبل أن تبدأ في الترميز، عليك أولاً تنفيذ بعض الخطوات.

دعم REST

تدعم واجهة برمجة تطبيقات REST عمليات CRUD الأساسية لنوعين مختلفين من الموارد:

سيكون الجزء المتبقي من هذه المستندات مكتوبًا بشكلٍ أساسي في سمة Product، ولكن يجب أن تكون العملية مشابهة بالنسبة إلى ProductCertification.

إعداد حسابك على Manufacturer Center

  1. أنشِئ حسابًا على Manufacturer Center.

  2. احرص على تذكّر عنوان البريد الإلكتروني الذي استخدمته لإنشاء حساب Manufacturer Center هذا، لأنّك ستحتاج إليه لاحقًا. في لقطات الشاشة، ستراها ممثلة على النحو التالي: manufacturer_user@example.com.

قدِّم أول طلب من واجهة برمجة التطبيقات (بدون إدخال أي رموز).

  1. انتقل إلى مستكشف واجهات برمجة التطبيقات في وثائق مطوري البرامج لـ Accounts.Products.list.

  2. تأكَّد من أنّ حساب Google الذي تم تسجيل الدخول إليه مُدرَج في إعداد "المستخدمون" في علامة التبويب "الإعدادات".

  3. في مستكشف واجهات برمجة التطبيقات، تأكَّد من تحديد Google OAuth 2.0 في القائمة المنسدلة المصادقة:

  4. أدخِل accounts/{account_id}، مع استبدال {account_id} بمعرّف الشركة المصنّعة من حسابك على Manufacturer Center، في الحقل "الرئيسية" للنموذج، وانقر على تنفيذ.

  5. من المفترض أن تظهر لك إجابة ناجحة. تهانينا! لقد قدّمت أول طلب للحصول على واجهة برمجة تطبيقات في Manufacturer Center.

  6. إذا لم يكن لديك أي منتجات في Manufacturer Center بعد، لن يكون هناك أي منتج في القائمة. في هذه المرحلة، يمكنك الانتقال إلى طلبات أخرى وإلقاء نظرة على كيفية عملها. وبما أنّ هذه الواجهة هي RESTful API، تعمل جميع الطلبات بشكل مشابه. بعد حصولك على المنتجات، ننصحك بتجربة Accounts.Products.get.

إنشاء مشروع على وحدة تحكُّم واجهة Google API

يتم إرسال الطلبات إلى واجهة برمجة تطبيقات Manufacturer Center من خلال مشروعك على وحدة تحكّم واجهة برمجة التطبيقات. ونفترض هنا أنّك ستصل إلى حسابك على Manufacturer Center، لذا ننصحك باستخدام حسابات الخدمة لتبسيط عملية المصادقة. يُرجى مراجعة دليل حسابات الخدمة لمزيد من التفاصيل حول كيفية إعداد حساب خدمة جديد لاستخدامه مع حسابك على Manufacturer Center.

أول طلب معتمد من واجهة برمجة التطبيقات باستخدام Java

بعد أن انتهيت من إعداد حساب الخدمة وإضافة رقم تعريف حساب الخدمة إلى حسابك على Manufacturer Center، يمكنك الوصول إلى حسابك باستخدام رمز النماذج المتوفّر. يستخدم هذا الدليل نماذج Java للتوضيح باستخدام واجهة برمجة التطبيقات.

  1. ثبِّت Apache Maven إذا لم يسبق لك إجراء ذلك.

  2. قم بتنزيل نماذج التسوق الخاصة بنا من صفحة GitHub.

  3. من داخل الدليل الفرعي java، أنشِئ نماذج Java:

    $ mvn compile

  4. شغِّل الآن الرمز ProductsListSample (مثال ProductCertification هو ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. إذا لم تتبع توجيهات التهيئة في الملف التمهيدي المرفق بملفات المصدر، فستحصل على خطأ يفيد بأنه لا يمكن العثور على نموذج تهيئة. اتبع الإرشادات الواردة في الملف README لإنشاء دليل التهيئة وتعبئته بالمعلومات المناسبة. يجب وضع ملف JSON الذي نزّلته أثناء إعداد حساب الخدمة في هذا الدليل مع اسم الملف service-account.json. تذكر أن تخبر التعليمة البرمجية بمكان ملفك عن طريق تعيين متغير البيئة التالي.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. بعد الانتهاء من ضبط إعدادات النماذج، شغِّل الرمز ProductsListSample مرة أخرى.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. في هذه المرحلة، من المفترض أن ينتهي تنفيذ برنامج Java، وأن يطبع إمّا قائمة المنتجات التي وجدها، أو رسالة تفيد بعدم وجود منتجات في حسابك. إذا ظهرت رسالة خطأ مثل "يتعذّر على المستخدم الوصول إلى الحساب 1234567890"، يرجح أن يكون السبب هو عدم إعداد حساب مستخدم الخدمة كمستخدم مفوّض في Manufacturer Center. من منظور واجهة برمجة التطبيقات، أرسل مشروع وحدة تحكم واجهة برمجة التطبيقات طلبًا بالنيابة عن مستخدم غير مُدرَج في قائمة مشرفي Manufacturer Center المعتمَدين، وبالتالي سيتم رفض هذا الطلب بالطبع.

  8. يمكنك تجربة تشغيل ProductsListSample بأي عدد تريده من المرات، لأنه طلب للقراءة فقط. يمكنك أيضًا استكشاف النماذج الأخرى التي أنشأناها لكل من Java و .NET.