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,
  "labelLink": string,
  "documentLink": 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 في النهاية ويستخدم الأرقام الجزئية 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) شهادة كفاءة في استخدام المنتج التي تربط الشهادات بالمنتجات.