REST Resource: accounts.languages.productCertifications

المرجع: Product Certification

بيانات اعتماد المنتج

تمثيل 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

اختياريّ. تاريخ انتهاء الصلاحية (UTC).

مشكلة

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

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

string

نوع المشكلة الذي أنشأه الخادم، مثل "INCORRECT_TEXT_FORMATING" أو "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

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