בדף הזה נסביר איך ליצור ולעדכן באופן פרוגרמטי מקורות נתונים שמאפשרים להוסיף מוצרים. מקורות נתונים אוטומטיים מאפשרים לכם לשלוח בקלות את נתוני המוצרים ל-Google. מקורות נתונים אוטומטיים מוודאים שהמידע העדכני ביותר על המוצרים הרלוונטיים מהאתר שלכם מגיע ל-Google.
Content API for Shopping מאפשר לכם ליצור מקורות נתונים ראשיים בלבד. בעזרת Merchant Data Sources API אפשר ליצור את הסוגים הבאים של מקורות נתונים:
- מקורות ראשיים של נתוני מוצרים
- מקורות משלימים לנתוני מוצרים
- מקורות נתונים של מלאי בחנות מקומית
- מקורות נתונים של מלאי אזורי
- מקורות לנתוני מבצעים
ב-Content API for Shopping אפשר לנהל רק מקורות נתונים עם קלט של קבצים. ב-Merchant API אפשר לנהל מקורות נתונים באמצעות קלט של קבצים וקלט API.
בעזרת ה-Merchant Data Sources API אפשר לבצע את הפעולות הבאות:
- יוצרים מקור נתונים ראשי חדש עם
feedLabelו-contentLanguageספציפיים. - יצירת מקור נתונים עם תו כללי לחיפוש. במקור נתונים עם תו כללי לחיפוש לא הוגדרו השדות
feedLabelו-contentLanguage. מקורות נתונים עם תווים כלליים לחיפוש מאפשרים להוסיף למקור נתונים מוצרים עם שילובים שונים שלfeedLabelו-contentLanguage. - צריך ליצור מקור נתונים משלים כדי לקשר למקור נתונים ראשי קיים.
- מגדירים לוח זמנים למקור נתונים של קובץ.
- ניהול מקורות נתונים של API.
- משתמשים בסוגים אחרים של מקורות נתונים, כמו קידומי מכירות.
דרישות מוקדמות
- צריך להעביר את החשבון שלכם לפידים של שפה יחידה.
כדי לוודא שהחשבון כבר הועבר לפיצול של יעדי נתונים, משתמשים ברשימת מקורות הנתונים או ב-methods. אם אתם לא עומדים בדרישות, במקרה כזה תקבלו את הודעת החריגה הבאה, ועליכם לפנות לתמיכה.
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
יצירת מקור נתונים חדש
כדי ליצור מקור נתונים ראשי חדש עם feedLabel ו-contentLanguage ספציפיים, מגדירים את השדות feedLabel ו-contentLanguage בהגדרות הספציפיות לסוג. לדוגמה: PrimaryProductDataSource.
כדי להציג את מקור הנתונים החדש שנוצר, צריך ליצור בקשה ל-GET או ל-LIST.
יצירת מקור נתונים ראשי חדש עם תו כללי לחיפוש
כדי ליצור פיד ראשי חדש עם תווים כלליים לחיפוש, צריך להגדיר את מקור הנתונים באמצעות PrimaryProductDataSource ולא להגדיר את השדות feedLabel ו-contentLanguage.
ב-Content API for Shopping נוצר רק מקור נתונים אחד ל-API. כשמשתמשים ב-Merchant Data Sources API, אפשר ליצור כמה מקורות נתונים של API, שחלקם יכולים להיות תווים כלליים לחיפוש.
רק מקורות נתונים עם קלט API יכולים להיות מקורות נתונים עם תווים כלליים לחיפוש. אין תמיכה במקורות נתונים עם תווים כלליים לחיפוש למקורות נתונים של קבצים.
יצירת מקור נתונים משלים וקישור שלו למקור הנתונים הראשי
אפשר להשתמש במקורות נתונים משלימים כדי לבצע עדכונים חלקיים בנתוני המוצרים. לשם כך, מוסיפים את המזהה הייחודי של מקור הנתונים כפרמטר של שאילתה, כשמבצעים קריאות ל-methods accounts.productInputs.insert ו-accounts.productInputs.delete. אפשר להשתמש במקורות נתונים משלימים רק כדי לעדכן מוצרים קיימים.
כדי ליצור מקור נתונים משלים, צריך להגדיר את מקור הנתונים באמצעות SupplementalProductDataSource ואז לקשר אותו על ידי עדכון השדה defaultRule במקור הנתונים הראשי.
מקורות נתונים משלימים של קבצים לא יכולים להיות מקורות נתונים עם תווים כלליים לחיפוש. מקורות הנתונים המשלימים ב-API תמיד צריכים להיות מקורות נתונים עם תווים כלליים לחיפוש.
הגדרת לוח זמנים למקור הנתונים של הקובץ
כדי להגדיר תזמון לפיד הקבצים, צריך להגדיר את מקור הנתונים כמקור נתונים של קובץ באמצעות השדה FileInput, ואז להגדיר את fetchsettings באמצעות השדה FileInput.FetchSettings.
מחיקת מקור נתונים
כדי למחוק מקור נתונים קיים מהחשבון, משתמשים ב-method accounts.dataSources.delete.
אחזור מקור הנתונים
כדי לאחזר קובץ שהוגדר במקור הנתונים, משתמשים ב-method accounts.dataSources.fetch. השיטה הזו מבצעת את אחזור הנתונים באופן מיידי במקור נתונים מהחשבון שלכם. השיטה הזו פועלת רק במקורות נתונים שהוגדר בהם קלט של קובץ.
אחזור של מקור נתונים
כדי לאחזר את ההגדרות של מקור הנתונים בחשבון, משתמשים ב-method accounts.dataSources.get.
הצגת רשימה של מקור הנתונים
כדי להציג את רשימת ההגדרות של מקורות הנתונים של החשבון, משתמשים ב-method accounts.dataSources.list.
מקור הנתונים של התיקונים
כדי לעדכן את ההגדרות של מקור נתונים קיים, משתמשים ב-method accounts.dataSources.patch.