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 בן 2 אותיות של שפה שנתמכת ב-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
}
שדות
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) אישור מוצר שמקשר בין אישורים למוצרים.