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