Method: accounts.productInputs.insert

מעלה קלט של מוצר לחשבון Merchant Center. אם כבר קיים קלט עם אותם ערכים ב-contentLanguage, ב-offerId וב-dataSource, השיטה הזו תחליף את הרשומה הזו.

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

בקשת HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. החשבון שאליו יתווסף המוצר הזה. פורמט: accounts/{account}

פרמטרים של שאילתה

פרמטרים
dataSource

string

חובה. שם המקור הראשי או המשלים של נתוני המוצרים. אם המוצר כבר קיים ומקור הנתונים שסופק שונה, המוצר יועבר למקור נתונים חדש. פורמט: accounts/{account}/dataSources/{datasource}

גוף הבקשה

גוף הבקשה מכיל מופע של ProductInput.

גוף התשובה

משאב זה מייצג נתוני קלט שאתם שולחים לגבי מוצר, ולא לגבי המוצר המעובד שמופיע ב-Merchant Center, במודעות שופינג או בפלטפורמות השונות של Google. המערכת משלבת קלט של מוצרים, כללים ונתוני מקור נתונים משלימים כדי ליצור את המוצר [product][google.shopping.content.bundles.Products.Product].

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

חובה לציין את המאפיינים הבאים: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] ו-[offerId][google.shopping.content.bundles.Products.offer_id].

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

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

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג 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}}"
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'. מספר התווים המקסימלי לכל מאפיין מותאם אישית הוא 10240 (המספר הכולל של תווים הוא השם והערך). אפשר להגדיר עד 2,500 מאפיינים מותאמים אישית לכל מוצר, והגודל הכולל הוא 102.4kB. אחרי ההוספה, קווים תחתונים בשמות של מאפיינים מותאמים אישית יוחלפו ברווחים.
versionNumber

string (int64 format)

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

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

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

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

היקפי ההרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/content

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.