מעלה קלט של מוצר לחשבון Merchant Center. אם כבר קיים קלט עם אותם ערכים ב-contentLanguage, ב-offerId וב-dataSource, השיטה הזו תחליף את הרשומה הזו.
אחרי שמוסיפים, מעדכנים או מוחקים קלט של מוצר, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המוצר המעובד.
בקשת HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
parent |
חובה. החשבון שאליו יתווסף המוצר הזה. פורמט: accounts/{account} |
פרמטרים של שאילתה
פרמטרים | |
---|---|
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 ( |
שדות | |
---|---|
name |
מזהה. השם של קלט המוצר. פורמט: |
product |
פלט בלבד. שם המוצר המעובד. פורמט: |
channel |
חובה. בלתי ניתן לשינוי. הערוץ של המוצר. |
offerId |
חובה. בלתי ניתן לשינוי. המזהה הייחודי של המוצר. הערך הזה חל גם על המוצר שהוזן על ידי המוצר וגם לגבי המוצר שעבר עיבוד. המערכת מסירה רווחים לבנים בתחילת הטקסט ובסופו, ורווחים מרובים מוחלפים ברווח לבן אחד מיד לאחר השליחה. פרטים נוספים זמינים במפרט נתוני המוצרים. |
contentLanguage |
חובה. בלתי ניתן לשינוי. קוד שפה בן שתי אותיות לפי תקן ISO 639-1 של המוצר. |
feedLabel |
חובה. בלתי ניתן לשינוי. תווית הפיד של המוצר. |
attributes |
זה שינוי אופציונלי. רשימה של מאפייני מוצרים. |
customAttributes[] |
זה שינוי אופציונלי. רשימה של מאפיינים מותאמים אישית (שהמוכר סיפק). אפשר להשתמש בו גם כדי לשלוח כל מאפיין של מפרט הנתונים בגרסה הכללית (לדוגמה, |
versionNumber |
זה שינוי אופציונלי. מייצג את הגרסה הקיימת (עדכניות) של המוצר, ואפשר להשתמש בה כדי לשמור על הסדר הנכון כשמבצעים כמה עדכונים בו-זמנית. אם המדיניות מוגדרת, המערכת מונעת את ההוספה של פריטים כשמספר הגרסה נמוך ממספר הגרסה הנוכחי של המוצר הקיים. אפשר לבצע הוספה מחדש (לדוגמה, רענון של המוצר אחרי 30 ימים) עם הערך הנוכחי של האפשרות הזו נתמכת רק עבור הכנסות למקורות נתונים ראשיים. אם הפעולה נמנעת, המערכת תבטל את החריגה שבוטלה. |
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/content
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.