البدء

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

إعداد حساب Manufacturer Center

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

يمكنك إنشاء طلبك الأول لواجهة برمجة التطبيقات (بدون سطر رمز).

  1. انتقِل إلى مستكشف واجهات برمجة التطبيقات في مستندات مطوّري البرامج عن Accounts.Products.list.
  2. تأكد من أن حساب Google الذي تم تسجيل الدخول إليه مدرجًا في 'Users' في علامة التبويب "الإعدادات".

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

  4. أدخِل accounts/{account_id}، مع استبدال {account_id} برقم تعريف Manufacturer Center من حسابك على Manufacturer Center، في الحقل 'parent' في النموذج، ثم انقر على تنفيذ.

    ملاحظة: إذا لم يسبق لك منح إذن OAuth2، سيُطلب منك الآن تفويض المكالمة.

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

إنشاء مشروع في Google API Console

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

ملاحظة: إذا كنت مهتمًا بإجراء مكالمات نيابةً عن العملاء باستخدام حساباتهم على Manufacturer Center، يُرجى الاطّلاع على دليل طلبات التفويض.

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

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

  1. ثبِّت Apache Maven إذا لم يسبق لك إجراء ذلك.
  2. يمكنك تنزيل عيّنات Shopping من صفحة GitHub.

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

    $ mvn compile
            

  4. شغِّل الآن الرمز ProductsListSample:

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

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

  6. الآن وبعد الانتهاء من إعداد النموذج، يمكنك تشغيل رمز ProductsListSample مرة أخرى.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            
  7. في هذه المرحلة، يجب أن ينتهي برنامج Java من الطباعة ويطبع قائمة بالمنتجات التي تم العثور عليها أو رسالة تفيد بأنّه ما مِن منتجات في حسابك. إذا ظهرت رسالة خطأ مثل "quot;User; ” لا يمكن الوصول إلى الحساب 1234567890&quot، فمن المرجّح أنّه لم يتم إعداد حساب مستخدم الخدمة كمستخدم مُعتمَد في Manufacturer Center. من وجهة نظر واجهة برمجة التطبيقات، أرسل مشروع وحدة تحكم واجهة برمجة التطبيقات طلبًا نيابةً عن مستخدم لم يكن في قائمة مشرفي Manufacturer Center المعتمدين، لذلك سيرفض هذا الطلب بالطبع.

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