REST Resource: accounts.languages.productCertifications

المورد: ProductCertification

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

تمثيل 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}/productCertifications/{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,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string
}
الحقول
name

string

مطلوب. تمثّل هذه السمة اسم شهادة الاعتماد.
authority

string

مطلوب. تمثّل هذه السمة اسم هيئة الاعتماد.
code

string

اختيارية: تمثّل هذه السمة رمزًا فريدًا لتحديد شهادة الاعتماد.
value

string

اختيارية: قيمة مخصّصة لشهادة الاعتماد
validUntil

string

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

المشكلة

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

تمثيل JSON 
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": string,
  "applicableCountries": [
    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)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
applicableCountries[]

string

النتائج فقط. قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تنطبق فيها المشكلة على منتج الشركة المصنّعة.

درجة الخطورة

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

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

IssueResolution

حلّ المشكلة

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

DestinationStatus

حالة الوجهة

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

string

اسم الوجهة
status

enum (Status)

تمثّل هذه السمة حالة الوجهة.
approvedCountries[]

string

النتائج فقط. قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تمت الموافقة على العرض فيها
pendingCountries[]

string

النتائج فقط. قائمة برموز البلدان (ISO 3166-1 alpha-2) التي ينتظر فيها العرض الترويجي الموافقة.
disapprovedCountries[]

string

النتائج فقط. قائمة برموز البلدان (ISO 3166-1 alpha-2) التي تم رفض العرض فيها.

الحالة

تمثّل هذه السمة الحالة.

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

الطُرق

delete

 تحذف هذه الطريقة شهادة اعتماد منتج حسب اسمه.

get

 تعرض هذه الطريقة شهادة اعتماد منتج حسب اسمه.

list

 تعرض هذه السمة شهادات اعتماد المنتجات الصادرة عن جهة إصدار شهادات محدّدة.

patch

 تعدّل هذه الطريقة شهادة المنتج (أو تنشئها إذا كانت allow_missing = true)، وهي تربط الشهادات بالمنتجات.