Method: accounts.issues.list

يسرد كل مشاكل الحساب في حساب Merchant Center.

طلب HTTP

GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/issues

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. المؤسسة الرئيسية التي تملك مجموعة الأعداد هذه. تنسيق الملف: accounts/{account}

معامِلات طلب البحث

المعلمات
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد المشاكل المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. وفي حال عدم تحديده، سيتم عرض 50 مستخدمًا كحدّ أقصى. الحد الأقصى للقيمة هو 100؛ سيتم فرض القيم الأكبر من 100 على 100

pageToken

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "issues.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى issues.list مع الاستدعاء الذي قدّم الرمز المميّز للصفحة.

languageCode

string

اختياريّ. ستحتوي المشاكل في الردّ على حقول يمكن للمستخدمين قراءتها باللغة المحدّدة. التنسيق هو BCP-47، مثل en-US أو sr-Latn. وإذا لم يتم تقديم قيمة، سيتم استخدام en-US.

timeZone

object (TimeZone)

اختياريّ. تشير هذه السمة إلى المنطقة الزمنية IANA والمستخدَمة لترجمة الأوقات في الحقول التي يمكن للإنسان قراءتها. على سبيل المثال، "America/Los_Angeles". إذا لم يتم ضبطها، ستظهر "America/Los_Angeles" تنبؤي.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ على الطريقة issues.list

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "accountIssues": [
    {
      object (AccountIssue)
    }
  ],
  "nextPageToken": string
}
الحقول
accountIssues[]

object (AccountIssue)

المشاكل من الحساب المحدّد.

nextPageToken

string

رمز مميز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/content

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

AccountIssue

AccountIssue

تمثيل JSON
{
  "name": string,
  "title": string,
  "severity": enum (Severity),
  "impactedDestinations": [
    {
      object (ImpactedDestination)
    }
  ],
  "detail": string,
  "documentationUri": string
}
الحقول
name

string

المُعرّف. اسم المورد لمشكلة الحساب. تنسيق الملف: accounts/{account}/issues/{id}

title

string

تمثّل هذه السمة العنوان المترجَم للمشكلة.

severity

enum (Severity)

درجة الخطورة العامة للمشكلة.

impactedDestinations[]

object (ImpactedDestination)

تأثير هذه المشكلة في الوجهات المختلفة.

detail

string

مزيد من التفاصيل المترجَمة حول هذه المشكلة

documentationUri

string

رابط ينقل إلى مركز مساعدة Merchant Center لتقديم معلومات إضافية حول المشكلة وكيفية حلّها

درجة الخطورة

جميع شدة المشكلات المحتملة.

عمليات التعداد
SEVERITY_UNSPECIFIED درجة الخطورة غير معروفة.
CRITICAL تؤدي هذه المشكلة إلى عدم عرض العروض.
ERROR قد تؤثّر هذه المشكلة على العروض الترويجية (في المستقبل) أو قد تكون مؤشرًا على وجود مشاكل في العروض.
SUGGESTION المشكلة هي اقتراح للتحسين.

ImpactedDestination

تأثير المشكلة في وجهة معيّنة

تمثيل JSON
{
  "impacts": [
    {
      object (Impact)
    }
  ],
  "reportingContext": enum (ReportingContextEnum)
}
الحقول
impacts[]

object (Impact)

التأثير (السلبي) لمناطق مختلفة في الوجهة المحدّدة.

reportingContext

enum (ReportingContextEnum)

سياق إعداد التقارير المتأثّر

التأثير

تأثير المشكلة في منطقة معيّنة

تمثيل JSON
{
  "regionCode": string,
  "severity": enum (Severity)
}
الحقول
regionCode

string

رمز CLDR للمنطقة حيث تنطبق هذه المشكلة

severity

enum (Severity)

مدى خطورة المشكلة في الوجهة والمنطقة.