REST Resource: accounts.languages.productCertifications

المورد: ProductCertificate

بيانات شهادة المنتج.

تمثيل JSON
{
  "name": string,
  "title": string,
  "brand": string,
  "mpn": [
    string
  ],
  "productCode": [
    string
  ],
  "countryCode": [
    string
  ],
  "productType": [
    string
  ],
  "certification": [
    {
      object (Certification)
    }
  ],
  "issues": [
    {
      object (Issue)
    }
  ],
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ]
}
الحقول
name

string

مطلوبة. معرّف الاسم الفريد لتنسيق شهادة المنتج: accounts/{account}/languages/{language_code}/productCertificates/{id} حيث يمثّل id معرّفًا فريدًا، بينما يمثّل language_code رمز ISO 639-1 مكوّنًا من حرفَين للغة متوافقة مع Shopping وفقًا https://support.google.com/merchants/answer/160637.

title

string

مطلوبة. تهدف هذه الخطوة إلى تحديد المنتج الذي تعتمده بوضوح.

brand

string

مطلوبة. هذا هو اسم العلامة التجارية للمنتج. تُستخدم العلامة التجارية للمساعدة في تحديد منتجك.

mpn[]

string

اختياريّ. هذه هي أرقام القطعة بحسب الشركة المصنّعة (MPN). تُستخدَم أرقام القطعة بحسب الشركة المصنّعة (MPN) لتحديد منتج معيّن بشكل فريد من بين كل المنتجات التي تنتجها الشركة المصنّعة نفسها.

productCode[]

string

اختياريّ. اسم آخر لرقم GTIN.

countryCode[]

string

اختياريّ. رمز بلد من حرفين (ISO 3166-1 Alpha 2).

productType[]

string

اختياريّ. تمثّل هذه السمة نظام تصنيف المنتجات الخاص بك في بيانات منتجاتك.

certification[]

object (Certification)

مطلوبة. قائمة بالشهادات التي يمكن ربطها بالمنتج الموصوف.

issues[]

object (Issue)

الإخراج فقط. قائمة المشاكل التي يُنشئها الخادم والمرتبطة بالمنتج

destinationStatuses[]

object (DestinationStatus)

الإخراج فقط. حالات الوجهات.

شهادة الاعتماد

وصف الشهادة.

تمثيل JSON
{
  "name": string,
  "authority": string,
  "value": string,
  "link": string,
  "logo": string,

  // Union field _valid_until can be only one of the following:
  "validUntil": string
  // End of list of possible types for union field _valid_until.
}
الحقول
name

string

مطلوبة. اسم الشهادة.

authority

string

مطلوبة. اسم نص الشهادة.

value

string

مطلوبة. قيمة مخصصة للشهادة.

حقل الاتحاد _valid_until.

يمكن أن يكون _valid_until واحدًا مما يلي فقط:

validUntil

string

اختياريّ. تاريخ انتهاء الصلاحية (التوقيت العالمي المنسق).

المشكلة

مشكلة في المنتج.

تمثيل JSON
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": string
}
الحقول
type

string

نوع المشكلة التي أنشأها الخادم، على سبيل المثال، "INCORRECT_TEXT_FORMATTING"، "IMAGE_NOT_SERVEABLE"، إلخ.

severity

enum (Severity)

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

attribute

string

السمة التي أدّت إلى حدوث المشكلة، إن وجدت. لمزيد من المعلومات حول السمات، راجع https://support.google.com/manufacturers/answer/6124116.

title

string

عنوان قصير يصف طبيعة المشكلة.

description

string

وصف أطول للمشكلة يركز على كيفية حلها.

resolution

enum (IssueResolution)

الإجراءات التي يجب اتخاذها لحلّ المشكلة

destination

string

الوجهة التي تنطبق عليها هذه المشكلة.

timestamp

string (Timestamp format)

الطابع الزمني لوقت ظهور هذه المشكلة.

طابع زمني بتنسيق RFC3339 UTC "Zulu"، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

درجة الخطورة

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

عمليات التعداد
SEVERITY_UNSPECIFIED درجة الخطورة غير محددة، لم يتم استخدامها مطلقًا.
ERROR درجة الخطأ: تمنع هذه المشكلة استخدام العنصر بأكمله.
WARNING درجة خطورة التحذير. والمشكلة إما أنها تمنع استخدام السمة التي شغّلتها أو تلك التي ستمنع قريبًا استخدام السلعة بأكملها.
INFO مستوى خطورة المعلومات. المشكلة لا تتطلب الانتباه الفوري. على سبيل المثال، تُستخدم هذه السمة في توضيح السمات التي لا تزال قيد المراجعة.

حل المشكلة

حل المشكلة.

عمليات التعداد
RESOLUTION_UNSPECIFIED درجة الدقة غير محددة، ولن يتم استخدامها مطلقًا.
USER_ACTION على المستخدم الذي قدّم البيانات اتخاذ الإجراءات اللازمة لحلّ المشكلة (على سبيل المثال، عن طريق تصحيح بعض البيانات).
PENDING_PROCESSING سيتم حل المشكلة تلقائيًا (على سبيل المثال، الزحف إلى الصور أو مراجعة Google). لا يلزم اتخاذ أي إجراء الآن. وقد يؤدي الحل إلى مشكلة أخرى (على سبيل المثال، في حال تعذَّر الزحف).

حالة الوجهة

حالة الوجهة.

تمثيل JSON
{
  "destination": string,
  "status": enum (Status)
}
الحقول
destination

string

اسم الوجهة.

status

enum (Status)

حالة الوجهة.

الحالة

الحالة.

عمليات التعداد
UNKNOWN حالة غير محددة، لم يتم استخدامها مطلقًا.
ACTIVE يتم استخدام المنتج لهذه الوجهة.
PENDING ولا يزال القرار في انتظار المراجعة.
DISAPPROVED تم رفض المنتج. يُرجى التحقق من المشاكل.

الطُرق

delete

حذف شهادة منتج حسب اسمها

get

يحصل على شهادة منتج حسب اسمه.

list

يسرد شهادات المنتج من نص شهادة محدّد.

patch

يتم تعديل شهادة منتج (أو إنشاء هذه السمة إذا allow_missing = true) لربط الشهادات بالمنتجات.