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-نرمال‌سازی می‌شود و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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 باشد، ایجاد می‌کند).