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

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

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

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

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

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

• مرجع مخصّص: مشاكل الحساب هي مرجع خاص بها. في 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 (سلسلة)، destination (سلسلة)	‫impactedDestinations (رسالة متكررة)	يتم الآن تنظيم التأثير في قائمة، مع تجميع الوجهة والمنطقة ومستوى الخطورة لكل منطقة متأثرة. يتم استبدال الحقل country بـ regionCode ضمن الرسالة Impact.
(غير متوفر)	‫language_code وtime_zone (مَعلمات الطلب)	تتيح المَعلمات الجديدة في طلب list ترجمة الحقول التي يمكن لشخص عادي قراءتها، مثل title وdetail.