REST Resource: accounts.productInputs

משאב: ProductInput

המשאב הזה מייצג את נתוני הקלט ששולחים לגבי מוצר, ולא את המוצר המעובד שמוצג ב-Merchant Center, במודעות שופינג או בפלטפורמות השונות של Google. הקלט של המוצרים, הכללים והנתונים של מקורות הנתונים המשניים משולבים כדי ליצור את Product המעובד.

המאפיינים הנדרשים של קלט המוצרים כדי לעבור את בדיקות אימות הנתונים מוגדרים בעיקר במפרט נתוני המוצרים.

המאפיינים הבאים נדרשים: feedLabel, ‏ contentLanguage ו-offerId.

אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד.

כל השדות בקלט של המוצר וההודעות המשנה שלו תואמים לשם באנגלית של המאפיין התואם במפרט התחום, עם כמה חריגים.

ייצוג ב-JSON 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
שדות
name

string

מזהה. השם של קלט המוצר. פורמט: "{productinput.name=accounts/{account}/productInputs/{productinput}}", כאשר הקטע האחרון productinput מורכב מ-4 חלקים: channel~contentLanguage~feedLabel~offerId. דוגמה לשם של קלט מוצר היא "accounts/123/productInputs/online~iw~IL~sku123"
product

string

פלט בלבד. השם של המוצר המעובד. פורמט: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

לא ניתן לשינוי. הערוץ של המוצר.
offerId

string

חובה. לא ניתן לשינוי. המזהה הייחודי של המוצר. הערך הזה זהה לקלט של המוצר ולמוצר המעובד. רווחים לבנים בתחילת הטקסט ובסופו יוסרו, ורווחים מרובים יוחלפו ברווח אחד בזמן השליחה. פרטים נוספים זמינים במפרט נתוני המוצרים.
contentLanguage

string

חובה. לא ניתן לשינוי. קוד השפה בן שתי האותיות של המוצר לפי תקן ISO 639-1.
feedLabel

string

חובה. לא ניתן לשינוי. תווית הפיד של המוצר.
attributes

object (Attributes)

אופציונלי. רשימה של מאפייני מוצרים.
customAttributes[]

object (CustomAttribute)

אופציונלי. רשימה של מאפיינים מותאמים אישית (שסופקו על ידי המוכר). אפשר גם להשתמש בו כדי לשלוח כל מאפיין של מפרט הנתונים בצורתו הגנרית (לדוגמה, { "name": "size type", "value": "regular" }). האפשרות הזו שימושית לשליחת מאפיינים שלא נחשפים במפורש על ידי ה-API, כמו מאפיינים נוספים שמשמשים את 'קונים ב-Google'. מספר התווים המקסימלי לכל מאפיין מותאם אישית הוא 10,240 (הוא מייצג את הסכום של התווים בשם ובערך). אפשר להגדיר עד 2,500 מאפיינים מותאמים אישית לכל מוצר, בגודל כולל של 102.4KB. קווים תחתונים בשמות של מאפיינים מותאמים אישית מוחלפים ברווחים בזמן ההוספה.
versionNumber

string (int64 format)

אופציונלי. מייצג את הגרסה הקיימת (עדכניות) של המוצר, וניתן להשתמש בו כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית.

אם ההגדרה הזו מוגדרת, ההוספה לא תתבצע אם מספר הגרסה נמוך ממספר הגרסה הנוכחי של המוצר הקיים. אפשר לבצע הוספה מחדש (לדוגמה, רענון המוצר אחרי 30 יום) באמצעות versionNumber הנוכחי.

התכונה נתמכת רק להוספה למקורות נתונים ראשיים.

אם הפעולה תימנע, תופעל החריגה 'הפעולה בוטלה'.

Methods

delete

 מחיקה של קלט של מוצר מחשבון Merchant Center.

insert

 העלאת קלט של מוצרים לחשבון Merchant Center.