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)

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