إدارة حسابك باستخدام Google Merchant API تساهم هذه الأداة في تحسين كفاءة إدارة بيانات المنتجات المعقّدة، ما يعزّز أداء "إعلانات Shopping". توضّح هذه المقالة مزايا Google Merchant API واستخداماته وتعليمات إعداده.
للاطّلاع على الترجمة بلغتك، يمكنك تشغيل الترجمة على YouTube. انقر على رمز "الإعدادات" في أعلى يسار مشغّل الفيديو، ثم انقر على "الترجمة والشرح"، واختَر لغتك.
في هذه الصفحة
- ما هي Merchant API؟
- بدء استخدام Merchant API
- تصحيح الأخطاء في واجهة برمجة التطبيقات باستخدام بيانات تشخيص واجهة برمجة التطبيقات
- الأسئلة الشائعة
ما هي Merchant API؟
تتيح لك واجهة Merchant API التفاعل مباشرةً مع حسابك على Merchant Center، وتتّبع فلسفة تصميم جديدة تشجع الابتكار بوتيرة أسرع لمواكبة التغيير. وهي إعادة تصميم وواجهة بديلة رسمية لواجهة Content API for Shopping، إذ تحلّ محلّها بصفتها الطريقة الأساسية لإدارة الإعدادات المعقّدة آليًا على نطاق واسع.
تزيد Merchant API بشكل كبير من فعالية إدارة الحسابات الكبيرة أو المعقّدة من خلال إتاحة الوصول الآلي لإدارة الحسابات والمنتجات ونظام إدارة المخزون آليًا، بالإضافة إلى تقارير الأداء. يساعدك ذلك في تحسين تجارب البيانات المجانية وإعلانات Shopping على Google، ويشكّل واجهة تكميلية لمنصة Merchant Center.
للاطّلاع على الترجمة بلغتك، يمكنك تفعيل الترجمة على YouTube. انقر على رمز الإعدادات في أعلى يسار مشغّل الفيديو، ثم انقر على الترجمة والشرح، واختَر لغتك.
طُرق استخدام Merchant API
تتيح لك Merchant API إدارة طريقة ظهور علامتك التجارية ومنتجاتك على Google والتحكّم فيها آليًا. وتتيح لك الواجهة المصمَّمة حديثًا الوصول إلى البيانات والإحصاءات والقدرات الفريدة على نطاق واسع وبسهولة. تتيح لك هذه الأداة إنشاء مصادر بيانات متعدّدة وإدارتها، ما يتيح تنظيم المعلومات بشكل أفضل حول المنتجات والعروض الترويجية والمراجعات. باستخدام Merchant API، يمكنك إدارة المنتجات بطريقة تكمل طُرق تحميل بيانات المنتجات الأخرى، مثل الملفات والخلاصة المبرمَجة. تتيح لك Merchant API أيضًا تنفيذ طلبات فردية متعددة في الوقت نفسه.
يمكنك استخدام Merchant API لإجراء ما يلي:
- الوصول آليًا إلى البيانات والإحصاءات والميزات لتوفير تجارب تسوّق على Google وخارجها
- تحسين تجارب البحث المجاني والإعلانات من خلال الإعدادات المتقدّمة والتقارير والإحصاءات والإشعارات
- واكِب التغيير من خلال الاستفادة من البنية المعيارية لواجهة برمجة التطبيقات.
يمكن الوصول إلى واجهة برمجة التطبيقات باستخدام gRPC أو REST. لمساعدتك في البدء، تتوافق واجهة Merchant API مع جميع لغات البرمجة الشائعة، بما في ذلك Java وPHP وPython وNode.js و.NET وبرمجة تطبيقات.
المزايا
- الاستفادة من أحدث التقنيات: يمكنك الاستفادة من واجهة برمجة تطبيقات أسرع وأكثر فعالية ليواكب نظامك موجة الابتكار التالية.
- الترقية بكفاءة أكبر: يتيح لك التصميم المعياري الجديد تنفيذ التغييرات وإطلاق الميزات الجديدة بسرعة أكبر وبجهد أقل.
- إدارة البيانات بسلاسة: يمكنك التحكّم بسهولة في الخلاصات المتعددة المصادر، ومدى التوفّر على مستوى المناطق، والمخزون على مستوى المتجر من واجهة واحدة مبسطة.
- الاستفادة من ميزات حصرية في واجهة برمجة التطبيقات فقط: يمكنك الوصول إلى أدوات فعّالة، مثل Google Product Studio لإنشاء صور مستندة إلى الذكاء الاصطناعي وتلقّي إشعارات مباشرة في حسابك.
بدء استخدام Merchant API
للاطّلاع على الترجمة بلغتك، يمكنك تفعيل الترجمة على YouTube. انقر على رمز الإعدادات في أعلى يسار مشغّل الفيديو، ثم انقر على الترجمة والشرح، واختَر لغتك.
قبل البدء
لتنفيذ طلب بيانات من واجهة برمجة التطبيقات Merchant API، يجب أن يتوفّر لديك ما يلي:
- حساب على Merchant Center: هذا هو الحساب الذي ستجري فيه عمليات البحث وتعديل البيانات وتحميلها. تأكَّد من أنّ لديك الأذونات اللازمة لإدارة المنتجات والمستودعات في هذا الحساب.
- مشروع على Google Cloud: يُستخدَم المشروع للحصول على إذن الوصول إلى واجهة برمجة التطبيقات في حسابك.
- تسجيل مستخدم واحد على الأقل لديه دور مطوّر واجهة برمجة التطبيقات: اربط حسابك على Merchant Center بمشروع على السحابة الإلكترونية من خلال إكمال عملية تسجيل المطوّر لمرة واحدة. وسيتلقّى مستخدمو مطوّري واجهة برمجة التطبيقات في الحساب المرتبط الرسائل المتعلقة بواجهة برمجة التطبيقات، بما في ذلك الإشعارات الإلزامية عن الخدمة والاستطلاعات المخصصة للمطوّرين والفرص المتاحة لهم.
المصادقة باستخدام Merchant API
استخدِم مستكشف Google APIs لتنفيذ طلبات Merchant API. يستخدم "مستكشف واجهات برمجة التطبيقات" بروتوكول Google OAuth 2.0 للمصادقة. قبل تنفيذ الطلبات، تأكَّد من وضع علامة في مربّع الاختيار Google OAuth 2.0.
لإجراء المصادقة باستخدام OAuth 2.0، عليك تسجيل الدخول إلى حسابك على Google، ثم إلى "مستكشف واجهات برمجة التطبيقات". عليك أيضًا السماح لأداة "مستكشف واجهات برمجة التطبيقات" بإدارة بيانات منتجاتك وحساباتك.
مزيد من المعلومات حول الخطوات الأولى في Merchant API
تصحيح الأخطاء في واجهة برمجة التطبيقات باستخدام بيانات تشخيص واجهة برمجة التطبيقات
إذا كانت طلبات البيانات من واجهة برمجة التطبيقات تتضمّن أخطاءً، قد تمنع متجرك من إدارة حضورك على Google ومن الوصول إلى العملاء على الإنترنت. لتشخيص الأخطاء المرتبطة بطلبات البيانات من واجهة برمجة التطبيقات وتصحيحها، انتقِل إلى علامة التبويب بيانات تشخيص واجهة برمجة التطبيقات التي تتيح لك تنفيذ ما يلي:
- عرض كل طلبات البيانات من واجهة برمجة التطبيقات التي نجحت وتلك التي تعذّر تنفيذها لفترة زمنية محدّدة
- تحديد عدد الطلبات التي نجحت وتلك التي تعذّر تنفيذها لكل إصدار وخدمة وطريقة خاصة بواجهة برمجة تطبيقات
- مراجعة أمثلة على الطلبات التي تعذّر تنفيذها
العثور على بيانات تشخيص واجهة برمجة التطبيقات
قد تؤدي الأخطاء في طلبات البيانات من واجهة برمجة التطبيقات إلى منع عرض منتجاتك على Google. اتّبِع التعليمات أدناه لمراجعة هذه الأخطاء:
- في حسابك على Merchant Center، انتقِل إلى الإعدادات
في قائمة التنقّل اليمنى.
- انقر على بيانات تشخيص واجهة برمجة التطبيقات.
في صفحة "بيانات تشخيص واجهة برمجة التطبيقات"، يمكنك تتبُّع الأخطاء المرتبطة بطلبات البيانات من واجهة برمجة التطبيقات وتشخيصها وتصحيحها. يمكنك أيضًا تحديد الطرق التي تتسبّب في حدوث أخطاء جسيمة في جميع إصدارات واجهة برمجة التطبيقات.
مراجعة طلبات البيانات من واجهة برمجة التطبيقات
تتضمّن صفحة "بيانات تشخيص واجهة برمجة التطبيقات" جزأين رئيسيَّين:
- طلبات البيانات من واجهة برمجة التطبيقات: رسم بياني للمخطط الزمني يعرض عدد طلبات البيانات من واجهة برمجة التطبيقات التي نجحت وتلك التي تعذّر تنفيذها لفترة زمنية محددة
- أداء طلبات البيانات من واجهة برمجة التطبيقات: جدول يعرض إجمالي عدد طلبات البيانات من واجهة برمجة التطبيقات وعدد الطلبات التي تعذّر تنفيذها
لمراجعة طلبات البيانات من واجهة برمجة التطبيقات:
- في حسابك على Merchant Center، انقر على الإعدادات
ضمن قائمة التنقّل على يمين الصفحة.
- انقر على بيانات تشخيص واجهة برمجة التطبيقات.
- استخدِم فلتر "الفترة الزمنية" لتحديد الفترة الزمنية.
- استخدِم شريط الفلترة في أعلى الصفحة لتحديد طلب خدمة واجهة برمجة التطبيقات وطريقته (مثل المنتجات التي تستخدم طريقة "الإدراج") الذي تريد مراجعته. ويتم تعديل كلٍ من الجدول والمخطط الزمني لعرض طلب خدمة واجهة برمجة التطبيقات المحدد وطريقته.
عرض طلبات البيانات التي تعذّر تنفيذها من واجهة برمجة التطبيقات
بعد أن يعرض الجدول نتائج نطاق البيانات المحدّد، يمكنك تصفّح الخدمات والطرق المدرَجة لتحدّد سريعًا أسباب تعذّر تنفيذ طلبات البيانات من واجهة برمجة التطبيقات. يتم إدراج الأخطاء تلقائيًا حسب اسم الخدمة، ولكن يمكنك تغيير نظام ترتيب الأخطاء من خلال النقر على عنوان عمود.
للاطّلاع على الطلبات التي تعذّر تنفيذها، يُرجى اتّباع الخطوتَين التاليتَين:
- في حسابك على Merchant Center، انقر على الإعدادات
ضمن قائمة التنقّل على يمين الصفحة.
- انقر على بيانات تشخيص واجهة برمجة التطبيقات.
- انتقِل إلى جدول "أداء طلبات البيانات من واجهة برمجة التطبيقات"، ثم اختَر العناصر ضِمن عمود "الطلبات التي تعذّر تنفيذها" لعرض تفاصيل إضافية حول طلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها.
- استخدِم التفاصيل الواردة في القسم "جميع الأخطاء المتعلقة بالمنتجات / الإدراج" الذي يظهر كإرشادات لتصحيح طلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها.
الأسئلة الشائعة
هل واجهة Merchant API هي نفسها Content API for Shopping؟
ما هي Content API for Shopping؟
روابط ذات صلة
- التعرّف على Merchant API
- نقل البيانات من Content API for Shopping إلى Merchant API
- استخدام Merchant API في "برمجة تطبيقات"
- آخر الأخبار
- الحصول على مساعدة بشأن Merchant API
Need more support?
To get help migrating to or integrating directly with Merchant API, complete this form.