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
}
الحقول
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 خطورة المعلومات هذه المشكلة لا تتطلّب الانتباه الفوري. على سبيل المثال، يتم استخدامه للإشارة إلى السمات التي لا تزال في انتظار المراجعة.

IssueResolution

حلّ المشكلة

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

DestinationStatus

حالة الوجهة

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

string

اسم الوجهة

status

enum (Status)

حالة الوجهة

الحالة

الحالة

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

الطُرق

delete

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

get

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

list

تُدرِج هذه السمة شهادات اعتماد المنتجات الصادرة عن جهة معيّنة لإصدار هذه الشهادات.

patch

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