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 הוא קוד בן 2 אותיות לפי תקן ISO 639-1 של שפה שנתמכת ב-Google שופינג, בהתאם לכתובת https://support.google.com/merchants/answer/160637.

title

string

חובה. כך אפשר לזהות בבירור את המוצר שאתם מאשרים.

brand

string

חובה. זה שם המותג של המוצר. המותג עוזר לזהות את המוצר.

mpn[]

string

אופציונלי. אלה מספרי החלקים שהיצרן הקצה לפריטים (קוד MPN). קודי MPN מאפשרים לזהות מוצר מסוים באופן ייחודי מבין כל המוצרים של אותו יצרן.

productCode[]

string

אופציונלי. שם אחר למספר GTIN.

countryCode[]

string

אופציונלי. קוד מדינה בן 2 אותיות (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

אופציונלי. תאריך התפוגה (UTC).

בעיה

בעיה במוצר.

ייצוג ב-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) שבהן הבעיה רלוונטית למוצר של היצרן.

מידת החומרה

חומרת הבעיה.

טיפוסים בני מנייה (enum)
SEVERITY_UNSPECIFIED חומרה לא מוגדרת, לא בשימוש.
ERROR חומרת השגיאה. הבעיה מונעת את השימוש בפריט כולו.
WARNING רמת החומרה של האזהרה. הבעיה מונעת את השימוש במאפיין שהפעיל אותה, או שהיא תמנע בקרוב את השימוש בפריט כולו.
INFO רמת חומרה: מידע. הבעיה לא דורשת טיפול מיידי. לדוגמה, הוא משמש כדי להודיע אילו מאפיינים עדיין ממתינים לבדיקה.

IssueResolution

פתרון הבעיה.

טיפוסים בני מנייה (enum)
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) שבהן המוצר נפסל.

סטטוס

הסטטוס.

טיפוסים בני מנייה (enum)
UNKNOWN סטטוס לא מוגדר, לא בשימוש.
ACTIVE המוצר משמש ליעד הזה.
PENDING ההחלטה עדיין בהמתנה.
DISAPPROVED המוצר נפסל. צריך לבדוק את הבעיות.

Methods

delete

מחיקת תעודת הסמכה למוצר לפי השם שלה.

get

מקבלת תעודת הסמכה למוצר לפי השם שלו.

list

מציג רשימה של תעודות הסמכה למוצרים מגוף מאשר מסוים.

patch

מעדכנת (או יוצרת, אם allow_missing = true) תעודת הסמכה למוצר שמקשרת בין תעודות הסמכה למוצרים.