نقل البيانات من accountstatuses إلى Account Issues

تغيّرت طريقة استرداد المشاكل على مستوى الحساب التي يمكن أن تؤثّر في منتجاتك وفي كفاءة حسابك. مقارنةً بالمرجع accountstatuses في Content API for Shopping، يقدّم Merchant API مرجعًا مخصّصًا AccountIssue يوفّر معلومات أكثر تنظيمًا وتفصيلاً.

لمزيد من المعلومات حول كيفية استخدام الميزة الجديدة، يُرجى الاطّلاع على دليل عرض مشاكل الحساب.

ملاحظة: في Merchant API، يتم تقسيم المشاكل على مستوى الحساب وحالات المنتجات المجمّعة. يمكنك أيضًا مراجعة دليلنا حول نقل البيانات من accountstatuses إلى حالات المنتجات المجمّعة.

الاختلافات الرئيسية

في ما يلي التحسينات والاختلافات الرئيسية في مورد Merchant API:AccountIssue

• مرجع مخصّص: مشاكل الحساب لها مرجع خاص بها. في Content API for Shopping، كانت المشاكل على مستوى الحساب حقلًا متداخلاً ضمن المورد العام AccountStatus. باستخدام Merchant API، يمكنك إدراجها مباشرةً باستخدام طريقة accounts.issues.list.
• بيانات التأثير المنظَّمة: يوفّر المرجع AccountIssue الحقل impactedDestinations المفصّل. يقدّم لك هذا الحقل تفصيلاً واضحًا لتأثير المشكلة، بما في ذلك الوجهة (مثل "إعلانات Shopping") والمنطقة المحدّدة ومدى خطورة المشكلة في تلك المنطقة.
• الخطورة كقيمة تعدادية: أصبح الحقل severity الآن قيمة تعدادية (مع قيم مثل CRITICAL وERROR وSUGGESTION)، ما يسهّل معالجته آليًا مقارنةً بالقيم المستندة إلى السلسلة في Content API for Shopping.
• المعرّفات الموحّدة: لكل مشكلة في الحساب مصدر فريد وكامل name بالتنسيق accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. يحلّ هذا النهج الموحّد محل السلسلة id من Content API for Shopping.
• إتاحة الترجمة: تتيح لك الطريقة accounts.issues.list تحديد language_code لتلقّي تفاصيل المشكلة، مثل العنوان والوصف، باللغة المفضّلة لديك. لم يكن ذلك ممكنًا في Content API for Shopping.
• سلوك الحساب المتقدّم: عند طلب accounts.issues.list في حساب متقدّم، لا يعرض سوى المشاكل التي تنطبق مباشرةً على هذا الحساب المتقدّم. ولا تعرض هذه الطريقة المشاكل في أيّ من حساباتها الفرعية. في Content API for Shopping، ستعرض طريقة accountstatuses.list الحالات لجميع الحسابات الفرعية. للحصول على مشاكل جميع الحسابات الفرعية في Merchant API، عليك استدعاء accounts.listSubaccounts ثم استدعاء accounts.issues.list لكل حساب فرعي على حدة.

الطلبات

في Merchant API، يمكنك إدراج مشاكل الحسابات الخاصة بحساب معيّن على Merchant Center.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

مقارنة عناوين URL الخاصة بالطلبات

وصف الطلب	واجهة برمجة تطبيقات المحتوى في Shopping	Merchant API
إدراج المشاكل على مستوى الحساب لحساب واحد	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
عرض المشاكل على مستوى الحساب لجميع الحسابات الفرعية لحساب متقدّم	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	هذه الميزة غير متوفّرة. يجب تكرار الحسابات الفرعية.

المعرّفات

تغيّرت معرّفات الحسابات والمشاكل في Merchant API.

مقارنة المعرّفات

وصف المعرّف	واجهة برمجة تطبيقات المحتوى في Shopping	Merchant API
معرّف الحساب	{MERCHANT_ID} و{ACCOUNT_ID} كمعلَمات مسار	{ACCOUNT_ID} كمَعلمة مسار بالتنسيق accounts/{ACCOUNT_ID}
معرّف المشكلة	حقل id في نص الردّ (على سبيل المثال، "products-that-enable-dishonest-behavior-hacking-policy").	حقل name في نص الاستجابة، وهو اسم المورد الكامل (على سبيل المثال، accounts/12345/issues/example-issue-id).

الطُرق

تم دمج طرق استرداد المشاكل في الحساب وتبسيطها في Merchant API.

مقارنة الطرق

واجهة برمجة تطبيقات المحتوى في Shopping	Merchant API	التوفّر والملاحظات
accountstatuses.get	accounts.issues.list	متاحة للحصول على مشاكل حساب واحد، استخدِم accounts.issues.list وحدِّد رقم تعريف الحساب. لا تتضمّن Merchant API طريقة get لمشكلة واحدة.
accountstatuses.list	لا يوجد مكافئ مباشر.	غير متوفّر لا تعرض الطريقة accounts.issues.list في Merchant API سوى المشاكل المتعلّقة بالحساب المحدّد، وليس بحساباته الفرعية. للحصول على مشاكل جميع الحسابات الفرعية، عليك أولاً طلب accounts.listSubaccounts ثم طلب accounts.issues.list لكل حساب فرعي.
accountstatuses.custombatch	لا يوجد مكافئ مباشر.	غير متوفّر لا تتوفّر المعالجة المجمّعة لمشاكل الحساب في Merchant API. يجب إجراء طلبات list فردية لكل حساب.

تغييرات الحقول التفصيلية

تم تعديل الحقول ضمن مصدر مشكلة الحساب لتوفير المزيد من البنية والوضوح.

مقارنة الحقول

واجهة برمجة تطبيقات المحتوى في Shopping	Merchant API	الوصف
accountLevelIssues (مصفوفة في AccountStatus)	accountIssues (مصفوفة في ListAccountIssuesResponse)	أصبحت المشاكل الآن مرجعًا مخصّصًا ذا مستوى أعلى، وليس حقلاً متداخلاً.
id (سلسلة)	name (سلسلة)	أصبح معرّف المشكلة الآن اسم مورد كاملاً، مثل accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (سلسلة)	title (سلسلة)	ما من تغيير:
detail (سلسلة)	detail (سلسلة)	ما من تغيير:
documentation (سلسلة)	documentationUri (سلسلة)	تمت إعادة تسمية الحقل لتوضيح أنّه عنوان URL.
severity (سلسلة)	severity (تعداد)	أصبح مستوى الخطورة الآن تعدادًا ثابتًا منظَّمًا (CRITICAL وERROR وSUGGESTION) بدلاً من سلسلة.
‫country (string)، destination (string)	impactedDestinations (رسالة متكرّرة)	تم الآن تنظيم التأثير في قائمة، مع تجميع الوجهة والمنطقة ودرجة الخطورة لكل منطقة متأثرة. يتم استبدال الحقل country بـ regionCode ضمن الرسالة Impact.
(غير متوفر)	‫language_code، time_zone (مَعلمات الطلب)	تسمح المَعلمات الجديدة في طلب list بتحديد اللغة للحقول التي يمكن لشخص عادي قراءتها، مثل title وdetail.