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