يقدّم هذا المستند إرشادات حول أفضل الممارسات. اطّلِع على نصائح متعلقة بالأداء للحصول على مزيد من المعلومات.
حالات استخدام واجهة برمجة التطبيقات
لإرسال الطلبات آليًا
سواء كنت تفضّل التشغيل الآلي لكل جزء من سير العمل أو إنشاء ربط بنظام تخطيط موارد المؤسسة (ERP)، تتيح لك Content API إرسال التعديلات فور تغيُّر المستودع.
لتلقّي ملاحظات فورية
في Content API، تتلقّى ردًا على كل طلب على الفور، بدلاً من تلقّيه من خلال ملخّص عبر البريد الإلكتروني بعد معالجة خلاصات البيانات. من المتوقّع حدوث تأخّر في استجابة الطلبات الكبيرة من خمس إلى عشرة ثوانٍ.
لتغيير بيانات المنتجات بشكل متكرّر
باستخدام Content API، يمكنك إجراء تعديلات تدريجية على مستودع المنتجات التي تشهد حركة بيع سريعة عدة مرات في اليوم، في حين أنّ إرسال خلاصة البيانات بالكامل في كل مرة ليس عمليًا. إذا أصبحت التحديثات متاحة بشكل فردي، أرسِلها individualmente، ولا تنتظر إلى أن تتوفّر عدة تحديثات حتى تتمكّن من جمعها معًا. وبالمثل، إذا كانت التحديثات متاحة في دفعات، أرسِلها في دفعات، ولا تقسمها إلى طلبات فردية.
لإدارة عدة حسابات فرعية
حسابات Merchant Center التي تم إنشاؤها حديثًا هي حسابات فردية تحتوي على مجموعة خاصة بها من بيانات المنتجات. يُعدّ هذا الإجراء مناسبًا في معظم الحالات، ولكن مع نمو حسابك، قد تحتاج إلى نظام إدارة أكثر تعقيدًا لمنتجاتك. إذا كان هذا هو الحال، ننصحك باستخدام حساب متعدّد العملاء. يمكن تنفيذ إدارة حساب MCA على مستوى واجهة برمجة التطبيقات من خلال خدمة "الحسابات"، كما تتيح هذه الخدمة إضافة الحسابات الفرعية وإدارتها آليًا. يمكنك الاطّلاع على مزيد من المعلومات حول كيفية الحصول على حساب MCA هنا.
كيفية استخدام واجهة برمجة التطبيقات
عدم استخدام واجهة برمجة التطبيقات بالطريقة نفسها التي تستخدم بها خلاصات البيانات
تجنَّب إجراء تعديلات يومية على خلاصة منتجاتك بالكامل عند استخدام مرجع products.
بدلاً من ذلك، عدِّل على وجه التحديد المنتجات التي تغيّرت بياناتها
فعليًا فقط. إنّ إرسال خلاصة بياناتك بالكامل من خلال مورد products يستهلك المزيد من
الوقت والموارد لكلّ من Google ولك.
لا تستخدِم واجهة برمجة التطبيقات لاسترداد معلومات المنتجات التي حمّلتها بانتظام.
إذا كنت مسؤولاً عن الاحتفاظ بمعلومات المنتجات في حساب معيّن على Merchant Center، تجنَّب طلب ملف العميل
معلومات من Content API من خلال الطريقتين
products.get
أو
products.list
بانتظام. بالنسبة إلى العملاء الذين يحمّلون المعلومات، يمكن أن تساعدك هذه الخطوات في تصحيح الأخطاء عند تصميم الحلول التي تستخدم Content API. ومع ذلك، لا يُقصد منها استرداد العميل لمعلومات المنتجات بشكل منتظم. يجب أن يكون لديك مصدر آخر لاطلاعنا على
معلومات منتجاتك، مثل قاعدة بيانات للمنتجات داخل المتجر، ويجب أن تعكس المنتجات
في Merchant Center محتوى هذا المصدر.
لا تستخدِم كلّ من خلاصات البيانات وContent API لإرسال سلع المنتجات.
إذا كنت تفكر في التبديل إلى واجهة برمجة التطبيقات لإرسال السلع، تأكَّد منعدم استخدام خلاصات البيانات بعد الآن لإرسال سلع المنتجات. إذا استمرّت في إرسال العناصر على كلتا الوسيطتَين، قد تظهر نتائج غير متوقّعة.
هل هناك طريقة يمكنني من خلالها استخدام واجهة برمجة التطبيقات وخلاصات البيانات معًا بأمان؟
يمكنك التلاعب بخلاصات البيانات باستخدام خدمة خلاصة البيانات في واجهة برمجة التطبيقات. على الرغم من أنّ هذا سيسهّل إدارة خلاصات البيانات على نطاق واسع، يجب ألا تدخِل المنتجات أو تعدّلها باستخدام واجهة برمجة التطبيقات في الوقت نفسه مع الخلاصات، لأنّ ذلك قد يؤدي إلى ظهور نتائج غير متوقّعة.
في ما يلي بعض الأمثلة الأخرى على الطرق المقبولة لاستخدام الخلاصات وواجهة برمجة التطبيقات معًا:
تنفيذ طلبات للقراءة فقط (الحصول على بيانات أو عرضها) من واجهة برمجة التطبيقات: يريد بعض التجّار استخدام واجهة برمجة التطبيقات لعرض معلومات وتعديلات على حالة منتجاتهم. وهذا أمر مقبول لأنّه لا يتم تعديل معلومات المنتجات إلا من خلال الخلاصات.
استخدام واجهة برمجة التطبيقات لإدارة حساباتك الفرعية (Accounts Service) و/أو إعدادات الضريبة والشحن على مستوى الحساب (Accounttax Service و Shippingsettings Service) هذه ليست وظائف يمكن أن تقدّمها خلاصات البيانات، لذا لا يتعارض استخدام واجهة برمجة التطبيقات مع إدارة هذه الدوال.
كيف يمكنني نقل البيانات من استخدام خلاصات البيانات إلى استخدام واجهة برمجة التطبيقات فقط أو العكس؟
إذا كنت تستخدِم حاليًا خلاصات بيانات وتريد التبديل إلى استخدام واجهة برمجة التطبيقات فقط لتعديل المنتجات، عليك إعادة تحميل بيانات منتجاتك باستخدام واجهة برمجة التطبيقات. عند استخدام service products لتعديل منتج معيّن، تتحكّم واجهة برمجة التطبيقات في معلومات المنتج، ولن يؤدي حذف المنتج من خلاصة البيانات أو حذف خلاصة البيانات نفسها إلى إزالة معلومات المنتج من حسابك على Merchant Center. تأكَّد من عدم توفّر أي تعديلات على خلاصة البيانات إذا كنت تريد إزالة المنتج من خلاصة البيانات أو خلاصة البيانات نفسها، وإلا ستستحوذ خلاصة البيانات على الملكية مجددًا وستؤدي إزالة المنتج من خلاصة البيانات إلى إزالة المنتج.
إذا كنت تستخدِم حاليًا واجهة برمجة التطبيقات فقط للحصول على معلومات المنتجات وأردت استخدام خلاصات البيانات كمصدرك الأساسي لمعلومات المنتجات، يمكنك ببساطة إضافة خلاصة البيانات الجديدة إلى حسابك على Merchant Center وستتم ملكية منتجاتك المدرَجة. إذا أردت إزالة منتجات تم تحميلها من خلال واجهة برمجة التطبيقات فقط قبل انتهاء صلاحيتها، عليك حذفها إما من خلال Merchant Center أو من خلال واجهة برمجة التطبيقات.
كيف يمكنني استهداف بلدان متعدّدة باستخدام المنتجات من خلال Content API for Shopping؟
لاستهداف بلدان متعدّدة من خلال الإعلانات والبيانات المجانية للمنتجات المرسَلة
عبر Content API، عليك ضبط بلدان إضافية في خلاصة Content API الأساسية
في Merchant Center أو إضافة هذه البلدان الإضافية من خلال الحقل shipping
في مرجع products.
في ما يلي مثال على كيفية تعديل إعدادات الخلاصة الأساسية في Content API.
لمزيد من المعلومات، يُرجى الاطّلاع على: استهداف إعلانات Shopping والبيانات المجانية في بلدان متعدّدة.
التأكّد من تحديث مكتبات العملاء
إذا كنت تستخدِم مكتبة برامج Google للتفاعل مع Content API، احرص على استخدام مدير الحِزم الخاص بلغة البرمجة التي اخترتها وتأكَّد من أنّ إصدار المكتبة محدّث. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المطوّر للغة التي اخترتها في عيّنات ومكتبات.
احرص على استخدام سمات الوجهات للتحكّم في المنتجات التي تظهر في برامج التسوّق المختلفة.
تتّبع Content API تلقائيًا الإعدادات التلقائية لخلاصة Content
API كما تم ضبطها في Merchant Center. يمكنك استخدام سمتَي المنتج
includedDestinations أو excludedDestinations للتحكّم في المشاركة في البرنامج على مستوى المنتج ضمن خلاصة أو من خلال
Content API.
إذا تم تفعيل خلاصة واجهة برمجة التطبيقات في أحد البرامج، مثل "الشراء على Google"
(المعروفة سابقًا باسم Shopping Actions)، ولكنك تريد استبعاد منتجات معيّنة،
استخدِم سمة excludedDestinations وحدِّد Shopping Actions كقيمة. في حال عدم حدوث أي أخطاء، سيؤدي ذلك إلى استبدال الإعدادات التلقائية
للقائمة في Merchant Center ولن تظهر هذه السلعة تحديدًا
في ميزة "الشراء على Google" (المعروفة سابقًا باسم Shopping Actions). في المقابل، إذا
لم يتم تفعيل خلاصتك في برنامج، مثل Shopping، يمكنك
تضمين سلع فردية باستخدام سمة includedDestinations وShopping_ads كقيمة، وسيظهر السلعة في إعلانات Shopping.
لمزيد من المعلومات حول سمات المنتج includedDestinations و
excludedDestinations، يُرجى الانتقال إلى
مركز المساعدة.
احرص على تعديل العناصر قبل انتهاء صلاحيتها.
إذا لم يتم تغيير العنصر قبل انتهاء صلاحيته، عليك تعديله بعد 30 يومًا من تاريخ التعديل الأخير أو في تاريخ انتهاء الصلاحية المحدّد إذا كان أقرب، وذلك لتجنّب إيقافه. إذا كنت بحاجة إلى تعديل العديد من العناصر لأنّه لم يتم تعديل أي منها أو لا يمكنك تتبُّع وقت آخر تعديل لها، لا ينبغي تعديل كل العناصر في الوقت نفسه، بل يجب توزيع التحميل بالتساوي على أيام متعددة.
لا تحذف خلاصة Content API، وإلا قد تختفي منتجاتك.
في المرة الأولى التي تحمِّل فيها منتجًا يتضمّن channel:online من خلال Content
API، ستظهر خلاصة جديدة في Merchant Center بعنوان Content API. في المرة
الأولى التي تحمِّل فيها منتجًا يتضمّن channel:local عبر Content API، ستظهر خلاصة
جديدة في Merchant Center بعنوان Content API وتتضمّن العنوان الفرعي
المنتجات المحلية. تأكَّد من عدم حذف خلاصة Content API على الإنترنت أو
على الجهاز عن طريق الخطأ. استنادًا إلى الخلاصة التي تحذفها، ستتم إزالة المنتجات على الإنترنت
أو المنتجات داخل المتجر التي أضفتها إلى Merchant Center من خلال Content API.
تجميع طلبات متعددة إلى الخدمة نفسها باستخدام طريقة custombatch
بدلاً من تقديم العديد من الطلبات التسلسلية أو المتزامنة إلى الخدمة نفسها، قدِّم طلب دفعة مخصّصة واحدًا يحتوي على جميع الطلبات المطلوبة. بهذه الطريقة، يحدث وقت الاستجابة لتقديم الطلبات إلى نقطة نهاية واجهة برمجة التطبيقات مرة واحدة فقط لطلب custombatch بدلاً من كل طلب فردي، وهو أمر مهم بشكل خاص إذا كنت تُقدّم طلبات متسلسلة.
عدم إرسال تعديلات متعددة لعنصر واحد في دفعة واحدة
سيؤدي ذلك إلى نتائج غير متوقّعة بسبب عدم التأكّد من تسلسل التحديثات، وقد يؤدي إلى خطأ تعارض.
عدم إرسال تعديلات على العناصر التي لم تتغيّر
احرص على إرسال طلبات لعناصر المنتجات الجديدة أو التي تم تغييرها أو حذفها فقط، إلا إذا كانت صلاحية العناصر ستنتهي في حال عدم إرسال طلبات بشأنها.
استخدام الخلاصات التكميلية في حال تغيُّر الأسعار و/أو مدى التوفّر بسرعة
إذا كنت تواجه مشكلة في إبقاء معلومات سعر المنتج أو مدى توفّره أو التخفيضات التي ينطبق عليها محدّثة، ننصحك باستخدام
الخلاصات التكميلية في مرجع products
لإرسال تعديلات على هذه السمات فقط. بما أنّ تعديلات الخلاصة التكميلية
صغيرة، يمكنك إجراء المزيد من تعديلات الخلاصة التكميلية في مدة معيّنة
مقارنةً بتعديلات المنتجات الكاملة، ما سيساعد في الحفاظ على أسعار منتجاتك
ومدى توفّرها بما يتوافق مع صفحاتك المقصودة.
يمكنك أيضًا تعديل سعر المنتج ومدى توفّره باستخدام التعديلات التلقائية على بيانات السلع. ويمكن استخدام هذه الميزة بالإضافة إلى تعديلات واجهة برمجة التطبيقات للمساعدة في تجنّب حدوث أيّ اختلافات بين المعلومات الواردة في Merchant Center والمعلومات الواردة في الصفحات المقصودة للمنتجات. يُرجى العلم أنّ هذه الميزة مصمّمة لحلّ المشاكل البسيطة المتعلقة بدقة بيانات السعر ومدى توفّر المنتجات، لذا لا تحلّ التعديلات التلقائية على بيانات السلع محلّ تقديم المعلومات الصحيحة أيضًا من خلال واجهة برمجة التطبيقات.
حالات استخدام رمز إعادة التنشيط
يتم عرض الرمز المميّز لإعادة التحميل في عنوان HTTP لطلبات التفويض. يحتوي هذا الرمز على الكثير من المعلومات الأخرى المتعلّقة بالمصادقة، ولكن رمز إعادة التنشيط هو غالبًا الرمز الذي يريد المطوّرون الحصول عليه، لأنّه يزيل الحاجة إلى مطالبة المستخدم بالمصادقة بشكل متكرّر، لأنّ رموز الوصول تستمر لمدة 60 دقيقة فقط قبل انتهاء صلاحيتها.