בדף הזה נסביר איך מעלים ומנהלים את המוצרים באופן פרוגרמטי. באמצעות Merchant Products API אפשר להוסיף או לעדכן מוצר במקור נתונים, לאחזר מוצר מהחשבון ולמחוק מוצר ממקור נתונים.
Merchant Products API מכיל שני משאבים.
productInputsrepresents the input parts of your products.productsמייצג את המוצרים שעברו עיבוד ונוצרו מחלקי הקלט.
השדה productInputs יכול להיות ראשי ומשלים, בהתאם לכך שהוא הועלה למקור נתונים ראשי או למקור נתונים משלים.
כל product מורכב מ-productInput ראשי אחד וממספר כלשהו של productInputs משלימים.
אפשר להשתמש ב-Merchant Products API כדי ליצור קטלוגים של מוצרים בחנות הפיזית או באינטרנט. אלה מוצרים שיכולים להופיע במספר יעדים של שופינג.
אפשר להשתמש במשאב productInputs אחרי שיוצרים את חשבון Merchant Center, מגדירים את מקור הנתונים הראשון ומוכנים להעלות קבוצה ראשונית של מוצרים דרך ה-API.
למוכרים יש אפשרות להעלות מוצרים באמצעות קובץ שנקרא PrimaryProductDataSource, אבל יש כמה יתרונות ליצירה ולמחיקה של מוצרים באמצעות Merchant API. היתרונות האלה כוללים זמני תגובה מהירים יותר ויכולת לעדכן מוצרים בזמן אמת, בלי צורך לנהל קבצים גדולים. יכול להיות שיחלפו כמה שעות עד ששינויים במוצרים שבוצעו באמצעות קריאות ל-API יופיעו במסד הנתונים של שופינג.
דרישות מוקדמות
אם אין לכם מקור נתונים, יוצרים מקור נתונים באמצעות Merchant DataSources API או Merchant Center.
אם כבר יש לכם מקור נתונים שיצרתם באמצעות ממשק המשתמש של Merchant Center או באמצעות ה-API, תוכלו להשתמש ב-Merchant Products API כדי להוסיף את המוצרים שלכם. אם אתם משתמשים ב-Content API for Shopping כדי להוסיף מוצרים, תוכלו לעיין במדריך ההעברה כדי להבין איך מתחילים להשתמש ב-Merchant Products API.
באחריותכם לציית לכללי המדיניות בנושא מודעות שופינג וכרטיסי מוצר חינמיים. צוות מודעות השופינג שומר לעצמו את הזכות לאכוף את כללי המדיניות האלה ולהגיב בהתאם אם נמצא תוכן או התנהגות שמפירים את כללי המדיניות האלה.
משאבים
המשאב products מאפשר לאחזר פרטי מוצרים ממסד הנתונים של שופינג.
המשאב productInput מייצג את נתוני הקלט ששולחים לגבי מוצר. בנוסף, ה-API מספק שיטות לעדכון או למחיקה של פרטי מוצרים, אחד אחרי השני או כמה בו-זמנית במצב באצווה. למשאב productInput צריכים להיות את השדות הבאים:
channel: הערוץ של המוצר.offerId: המזהה הייחודי של המוצר.contentLanguage: קוד השפה בן שתי האותיות של המוצר לפי תקן ISO 639-1.feedLabel: תווית הפיד של המוצר.
העלאת קלט של מוצרים לחשבון
כדי להעלות קלט של מוצר לחשבון, משתמשים בשיטה accounts.productInputs.insert. צריך להעביר את המזהה הייחודי של מקור הנתונים הראשי או המשלים.
אחזור מוצר מעובד מהחשבון
כדי לאחזר מוצר מעובד מהחשבון, משתמשים בשיטה accounts.products.get. יכול להיות שיחלפו כמה דקות עד שהמוצר המעובד יופיע אחרי ההוספה.
אפשר לקבל את שם המשאב של המוצר המעובד מהשדה product בתגובה של accounts.productInputs.insert
מחיקת קלט של מוצר מהחשבון
כדי למחוק קלט של מוצר מהחשבון, משתמשים ב-method accounts.productInputs.delete. כדי למחוק מוצר באמצעות Merchant Products API, צריך להעביר את המזהה הייחודי של מקור הנתונים הראשי או המשלים שאליו המוצר שייך.
הצגת מוצרים מהחשבון
כדי לקבל רשימה של המוצרים שעברו עיבוד בחשבון, משתמשים ב-method accounts.products.list.