البدء

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

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

دعم REST

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

  • Product لمالكي العلامات التجارية وشركاء البيانات.
  • وProductCertificate لجهات الاعتماد.

ستتم كتابة بقية هذه المستندات بشكل أساسي في Product، ولكن ينبغي أن تكون العملية مشابهة لـ ProductCertificate.

إعداد حسابك على 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، تعمل جميع الطلبات بالطريقة نفسها. من المفيد بعد ذلك تجربة Accounts.Products.get بعد الحصول على المنتجات.

إنشاء مشروع وحدة تحكم Google API

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

أول طلب مُعتمَد لواجهة برمجة التطبيقات يستخدم جافا

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

  1. ثبِّت Apache Maven، إذا لم يسبق لك تثبيته.

  2. يمكنك تنزيل نماذج Shopping من صفحة GitHub.

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

    $ mvn compile
    
  4. شغِّل الآن الرمز ProductsListSample (مثال على ProductCertificate سيكون ListProductCertificationsSample):

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. إذا لم تتّبع توجيهات التهيئة الواردة في ملف README المصاحب للملفات المصدر، ستظهر لك رسالة خطأ تفيد بعدم إمكانية العثور على نموذج للتهيئة. اتبع الإرشادات في 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. عند هذه النقطة، يجب أن ينتهي برنامج جافا من التنفيذ، ويطبع إما قائمة بالمنتجات التي عثر عليها، أو رسالة تفيد بعدم وجود أي منتجات في حسابك. إذا ظهرت رسالة خطأ مثل "يتعذّر على المستخدم الوصول إلى الحساب 1234567890"، قد يعود السبب على الأرجح إلى عدم إعداد حساب مستخدم الخدمة كمستخدم معتمد في Manufacturer Center. من ناحية واجهة برمجة التطبيقات، أرسل مشروع وحدة تحكم واجهة برمجة التطبيقات طلبًا نيابةً عن مستخدم لم يكن في قائمة مشرفي Manufacturer Center المعتمدين، وبالتالي سيرفض هذا الطلب بالطبع.

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