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

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

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

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

في ما يلي التحسينات والاختلافات الرئيسية في مورد 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/v1beta/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/v1beta/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 وحدِّد رقم تعريف الحساب. لا تتضمّن واجهة برمجة التطبيقات الخاصة بالتاجر الطريقة 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.