يقدّم هذا المستند إرشادات حول أفضل الممارسات. يمكنك الاطّلاع على نصائح الأداء للحصول على مزيد من المعلومات.
حالات استخدام واجهة برمجة التطبيقات
إرسال الطلبات آليًا
سواء كنت تفضّل أتمتة كل جزء من سير عملك أو إنشاء خطاف في نظام تخطيط موارد المؤسسة (ERP)، تتيح لك Content API إرسال التعديلات فور تغيُّر مستودعك.
للحصول على ملاحظات فورية
في Content API، تتلقّى ردًا على كل طلب على الفور، بدلاً من تلقّي ملخّص عبر البريد الإلكتروني بعد معالجة خلاصات البيانات. من المتوقّع حدوث تأخير من خمس إلى عشر ثوانٍ في طلبات الدفعات الكبيرة.
لتغيير بيانات المنتجات بشكل متكرّر
باستخدام Content API، يمكنك إجراء تعديلات تدريجية على مستودع المنتجات الرائجة عدة مرات في اليوم، في حين أنّ إرسال خلاصة البيانات بأكملها في كل مرة ليس خيارًا عمليًا. إذا أصبحت التحديثات متاحة بشكل فردي، أرسِلها بشكل فردي، ولا تنتظر إلى أن تتوفّر عدة تحديثات لتجميعها. وبالمثل، إذا كانت التحديثات متاحة على شكل دفعات، أرسِلها على شكل دفعات، ولا تقسمها إلى طلبات فردية.
لإدارة عدة حسابات فرعية
حسابات Merchant Center التي تم إنشاؤها حديثًا هي حسابات فردية تحتوي على مجموعة خاصة من بيانات المنتجات. هذه الطريقة فعّالة في معظم الحالات، ولكن مع نمو حسابك، قد تحتاج إلى نظام إدارة أكثر تعقيدًا لمنتجاتك. إذا كان هذا هو الحال بالنسبة إليك، ننصحك باستخدام حساب متعدّد العملاء. يمكن إجراء إدارة حساب على مستوى واجهة برمجة التطبيقات لحساب إداري (مركز عملائي) من خلال خدمة "الحسابات"، كما تتيح إضافة الحسابات الفرعية وإدارتها آليًا. يمكنك الاطّلاع على مزيد من المعلومات حول كيفية الحصول على حساب على "مركز تطبيقات المطوّرين" هنا.
كيفية استخدام واجهة برمجة التطبيقات
عدم استخدام واجهة برمجة التطبيقات كما تستخدم خلاصات البيانات
تجنَّب تعديل خلاصة منتجاتك بالكامل يوميًا عند استخدام مصدر products.
بدلاً من ذلك، عدِّل فقط المنتجات التي تغيّرت بياناتها. يؤدي إرسال خلاصة البيانات بأكملها عبر المورد products إلى استهلاك المزيد من الوقت والموارد من جانبك ومن جانب Google.
عدم استخدام واجهة برمجة التطبيقات لاسترداد معلومات المنتجات التي حمّلتها بانتظام
إذا كنت مسؤولاً عن الاحتفاظ بمعلومات المنتجات في حساب معيّن على Merchant Center، تجنَّب طلب معلومات المنتجات من Content API بانتظام من خلال الطريقتَين products.get أو products.list. بالنسبة إلى العملاء الذين يحمّلون المعلومات، يمكن أن تساعدك هذه الطرق في تصحيح الأخطاء عند تصميم حلول تستخدم Content API. ومع ذلك، لا يُفترض أن تستخدم هذه التطبيقات واجهات برمجة التطبيقات بشكل منتظم لاسترداد معلومات المنتجات. يجب أن يتوفّر لديك مصدر آخر لمعلومات منتجاتك، مثل قاعدة بيانات المنتجات المحلية، ويجب أن تعكس المنتجات في Merchant Center محتوى هذا المصدر.
لا تستخدِم كلاً من خلاصات البيانات وContent API لإرسال سلع المنتجات
إذا كنت تفكّر في التبديل إلى واجهة برمجة التطبيقات لإرسال السلع، تأكَّد من أنّك لم تعُد تستخدم خلاصات البيانات لإرسال سلع المنتجات. في حال استمرارك في إرسال عناصر على كلا الوسيطَين، قد تحدث نتائج غير متوقّعة.
هل هناك طريقة يمكنني من خلالها استخدام واجهة برمجة التطبيقات وخلاصات البيانات معًا بأمان؟
يمكنك تعديل خلاصات البيانات باستخدام خدمة "خلاصة البيانات" في واجهة برمجة التطبيقات. مع أنّ ذلك سيجعل إدارة خلاصات البيانات على نطاق واسع أسهل بكثير، يُرجى العِلم أنّه يجب عدم إدراج المنتجات أو تعديلها باستخدام واجهة برمجة التطبيقات بشكل متزامن مع الخلاصات، لأنّ ذلك قد يؤدي إلى نتائج غير متوقّعة.
تشمل بعض الأمثلة الأخرى على الطرق المقبولة لاستخدام الخلاصات وواجهة برمجة التطبيقات معًا ما يلي:
تنفيذ طلبات القراءة فقط (get أو list) من واجهة برمجة التطبيقات: يريد بعض التجّار استخدام واجهة برمجة التطبيقات لجلب المعلومات وتعديلات الحالة الخاصة بمنتجاتهم. وهذا مقبول لأنّه يتم تعديل معلومات المنتجات فقط من خلال الخلاصات.
استخدام واجهة برمجة التطبيقات لإدارة حساباتك الفرعية (Accounts Service) و/أو إعدادات الضريبة والشحن على مستوى الحساب (Accounttax Service وShippingsettings Service) هذه ليست وظائف يمكن أن توفّرها خلاصات البيانات، لذا لا يوجد تعارض مع استخدام واجهة برمجة التطبيقات لإدارة هذه الوظائف.
كيف يمكنني الانتقال من استخدام خلاصات البيانات إلى استخدام واجهة برمجة التطبيقات فقط أو العكس؟
إذا كنت تستخدم حاليًا خلاصات البيانات وأردت التبديل إلى استخدام واجهة برمجة التطبيقات فقط لتعديل المنتجات، عليك إعادة تحميل بيانات منتجاتك باستخدام واجهة برمجة التطبيقات. عند استخدام خدمة المنتجات لتعديل منتج معيّن، يتحكّم واجهة برمجة التطبيقات في معلومات المنتج، ولن يؤدي حذف المنتج من خلاصة البيانات أو حذف خلاصة البيانات نفسها إلى إزالة معلومات المنتج من حسابك على Merchant Center. تأكَّد من عدم إجراء أي تعديلات على خلاصة البيانات إذا كنت تريد إزالة المنتج من خلاصة البيانات أو من خلاصة البيانات نفسها، وإلا ستتولّى خلاصة البيانات ملكية المنتج مرة أخرى وستؤدي إزالته من خلاصة البيانات إلى إزالته.
إذا كنت تستخدم حاليًا واجهة برمجة التطبيقات فقط للحصول على معلومات المنتجات وتريد استخدام خلاصات البيانات كمصدر أساسي لمعلومات المنتجات، يمكنك ببساطة إضافة خلاصة البيانات الجديدة إلى حسابك على Merchant Center، وسيتولّى الشريك مسؤولية المنتجات المدرَجة. إذا أردت إزالة منتجات تم تحميلها من خلال واجهة برمجة التطبيقات فقط قبل انتهاء صلاحيتها، عليك حذفها إما من خلال Merchant Center أو من خلال واجهة برمجة التطبيقات.
كيف يمكنني استهداف بلدان متعددة بالمنتجات باستخدام Content API for Shopping؟
لاستهداف بلدان متعددة باستخدام الإعلانات والبيانات المجانية للمنتجات التي يتم إرسالها عبر Content API، اضبط بلدانًا إضافية في الخلاصة الأساسية لـ Content API في Merchant Center أو أضِف هذه البلدان الإضافية عبر الحقل shipping في مرجع products.
في ما يلي مثال على كيفية تعديل إعدادات الخلاصة الأساسية في Content API.
لمزيد من المعلومات، يُرجى الاطّلاع على: استهداف إعلانات Shopping والبيانات المجانية في بلدان متعدّدة.
التأكّد من أنّ مكتبات البرامج محدَّثة
إذا كنت تستخدم مكتبة برامج عميل من Google للتفاعل مع Content API، احرص على استخدام مدير الحِزم للغة البرمجة التي اخترتها وتأكَّد من أنّ إصدار المكتبة محدّث. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المطوّرين الخاص باللغة التي اخترتها في النماذج والمكتبات.
احرص على استخدام سمات الوجهات للتحكّم في المنتجات التي تظهر في برامج Shopping المختلفة.
تعتمد 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 واحد يتضمّن جميع الطلبات المطلوبة. بهذه الطريقة، يحدث تأخير إرسال الطلبات إلى نقطة نهاية واجهة برمجة التطبيقات مرة واحدة فقط لطلب custombatch بدلاً من حدوثه في كل طلب فردي، وهو أمر مهم بشكل خاص إذا كنت بصدد إرسال طلبات متسلسلة.
عدم إرسال تعديلات متعددة على عنصر واحد في دفعة واحدة
سيؤدي ذلك إلى نتائج غير متوقّعة بسبب عدم التأكّد من تسلسل التعديلات، وقد يتسبّب في حدوث خطأ تعارض.
عدم إرسال إشعارات بشأن العناصر التي لم تتغيّر
احرص على إرسال طلبات لعناصر المنتجات الجديدة أو المعدَّلة أو المحذوفة فقط، ما لم تنتهِ صلاحية العناصر.
استخدام الخلاصات الإضافية إذا تغيّرت الأسعار و/أو مدى التوفّر بسرعة
إذا كنت تواجه صعوبة في إبقاء معلومات السعر أو التوفّر أو التخفيضات محدّثة، ننصحك باستخدام الخلاصات التكميلية في مرجع products لإرسال التعديلات لهذه السمات فقط. بما أنّ تعديلات الخلاصة التكميلية صغيرة، يمكنك إجراء عدد أكبر بكثير من تعديلات الخلاصة التكميلية في فترة زمنية معيّنة مقارنةً بتعديلات المنتجات الكاملة، ما سيساعد في الحفاظ على تطابق أسعار منتجاتك ومدى توفّرها مع الصفحات المقصودة.
هناك طريقة أخرى لتعديل سعر المنتج ومدى توفّره وهي استخدام ميزة التعديلات التلقائية على بيانات السلع. يمكن استخدام هذه الميزة بالإضافة إلى تعديلات واجهة برمجة التطبيقات للمساعدة في تجنُّب حدوث أيّ اختلافات بين المعلومات في Merchant Center والمعلومات في الصفحات المقصودة للمنتجات. يُرجى العِلم أنّ هذه الميزة مصمَّمة لحلّ المشاكل البسيطة المتعلقة بدقة بيانات السعر ومدى التوفّر، لذا لا تحلّ التعديلات التلقائية على بيانات السلع محلّ توفير المعلومات الصحيحة من خلال واجهة برمجة التطبيقات.
حالات استخدام الرمز المميز لإعادة التحميل
يتم عرض رمز إعادة التحميل في عنوان HTTP لطلبات التفويض. ويحتوي على الكثير من المعلومات الأخرى ذات الصلة بالمصادقة، ولكن غالبًا ما يكون رمز التحديث هو الجزء الذي يريد المطوّرون الحصول عليه، لأنّه يزيل الحاجة إلى مطالبة المستخدم بالمصادقة بشكل متكرّر، إذ لا تدوم رموز الدخول سوى 60 دقيقة قبل انتهاء صلاحيتها.