تغيّرت الطريقة التي تستردّ بها المشاكل على مستوى الحساب التي يمكن أن تؤثّر في منتجاتك وحالة حسابك. مقارنةً بمورِد 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 للطلبات
| وصف الطلب | Content API for 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.
مقارنة المعرّفات
| وصف المعرّف | Content API for 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.
مقارنة الطُرق
| Content API for 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 فردية لكل حساب. |
التغييرات التفصيلية في الحقول
تم تعديل الحقول ضمن مورِد مشاكل الحساب لتوفير المزيد من التنظيم والوضوح.
مقارنة الحقول
| Content API for 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. |