בדף הזה מוסבר איך ליצור ולעדכן באופן פרוגרמטי מקורות נתונים מאפשרות להוסיף מוצרים. מקורות נתונים אוטומטיים מאפשרים לשלוח בקלות את נתוני המוצרים שלכם ל-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.
- ניהול כלל ברירת המחדל של מקורות נתונים באמצעות מקורות ראשיים של נתוני מוצרים.
- להשתמש בסוגים אחרים של מקורות נתונים, כמו קידומי מכירות.
לא ניתן להשתמש ב-Merchant API כדי להוסיף מוצרים במקור נתונים שמכיל גם בחנויות מקומיות וגם במוצרים באינטרנט. מידע נוסף על מקורות נתונים ערוצים, ראה ערוצים.
דרישות מוקדמות
- צריך להעביר את החשבון שלכם לפידים של שפה יחידה.
כדי לוודא שהחשבון כבר הועבר לחלוקת יעדי נתונים, משתמשים ברשימה של מקורות הנתונים או בשיטות ה-get. אם לא תהיו זכאים להטבה, תקבלו את הודעת החריגה הבאה, ועליכם לפנות לתמיכה.
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.
יצירת מקור נתונים חדש
מקורות הנתונים הראשיים הם מקורות הנתונים העיקריים למלאי שלכם ב-Merchant Center. אפשר להוסיף או להסיר מוצרים רק באמצעות מקור נתונים ראשי. אם כל אחד מהמוצרים שאתם מוסיפים למקור הנתונים הראשי עומד בדרישות הסף ובדרישות הנתונים של Merchant Center, לא תצטרכו ליצור מקורות נתונים נוספים.
כדי ליצור מקור נתונים ראשי חדש עם ערך ספציפי של feedLabel
וגם
contentLanguage
, מגדירים את השדות feedLabel
ו-contentLanguage
תצורה ספציפית לסוג מסוים. למידע נוסף על השדות האלה,
ראה PrimaryProductDataSource
.
מידע נוסף על יצירת מקור נתונים זמין ב-method accounts.dataSources.create.
כדי להציג את מקור הנתונים החדש שיצרתם, משתמשים ב-method accounts.dataSources.get או ב-method accounts.dataSources.list.
ליצור מקור נתונים ראשי חדש שיעזור לטרגט כמה מדינות
כדי ליצור פיד ראשי חדש שיעזור לכם לטרגט כמה מדינות, מגדירים את מקור הנתונים באמצעות PrimaryProductDataSource
ולא מגדירים את השדות feedLabel
ו-contentLanguage
.
ב-Content API for Shopping נוצר רק מקור נתונים אחד ב-API עבור
את/ה. כשמשתמשים ב-Merchant Data Sources API, אפשר להגדיר כמה מקורות נתונים ב-API,
שחלקם יכולים להכיל את השדות feedLabel
ו-contentLanguage
,
רק מקורות נתונים עם קלט API יכולים להיות ללא הגדרת השדות feedLabel
ו-contentLanguage
. סוג זה של מקורות נתונים אינו נתמך בקובץ
של קלטים.
יצירת מקור נתונים משלים וקישור שלו למקור הנתונים הראשי
מקורות נתונים משלימים משמשים רק לעדכון נתוני מוצרים שכבר קיים במקור נתונים ראשי אחד או יותר. אפשר ליצור כמה מקורות נתונים משלימים, וכל אחד מהם יכול להשלים את הנתונים של כמה מקורות נתונים ראשיים.
אפשר להשתמש במקורות נתונים משלימים כדי לבצע עדכונים חלקיים בנתוני המוצרים,
הוספת המזהה הייחודי של מקור הנתונים כפרמטר של שאילתה כשמבצעים
קריאות ל
accounts.productInputs.insert
וגם
accounts.productInputs.delete
שיטות. אפשר להשתמש במקורות נתונים משלימים רק כדי לעדכן מוצרים קיימים.
כדי ליצור מקור נתונים משלים, מגדירים את מקור הנתונים באמצעות SupplementalProductDataSource
ולאחר מכן מקשרים אותו על ידי עדכון השדה defaultRule
במקור הנתונים הראשי.
מקורות נתונים משלימים של קבצים צריכים לכלול את feedLabel
ואת contentLanguage
הוגדרו. מקורות נתונים משלימים של API תמיד צריכים לכלול את הערכים feedLabel
וגם
contentLanguage
שדות לא הוגדרו.
הגדרת תזמון למקור נתוני הקובץ
כדי להגדיר תזמון לפיד הקבצים צריך להגדיר את מקור הנתונים כקובץ
מקור נתונים באמצעות השדה FileInput
, ואז מגדירים
fetchsettings
באמצעות השדה FileInput.FetchSettings
.
מחיקה של מקור נתונים
כדי למחוק מקור נתונים קיים מהחשבון, משתמשים ב-method accounts.dataSources.delete
.
אחזור מקור הנתונים
כדי לאחזר קובץ שהוגדר במקור הנתונים, משתמשים ב-method accounts.dataSources.fetch
. השיטה הזו מבצעת את אחזור הנתונים באופן מיידי ממקור נתונים מהחשבון שלכם. השיטה הזו פועלת רק במקורות נתונים שהוגדר בהם קלט של קובץ.
אחזור של מקור נתונים
כדי לאחזר את ההגדרות של מקור הנתונים בחשבון, משתמשים בשיטה accounts.dataSources.get
.
הצגת רשימה של מקורות הנתונים
כדי לקבל רשימה של ההגדרות של מקורות הנתונים בחשבון, משתמשים ב-method accounts.dataSources.list
.
מקור הנתונים של התיקונים
כדי לעדכן את ההגדרה של מקור נתונים קיים, משתמשים ב-method accounts.dataSources.patch
.
קישור מקורות נתונים
המקורות הראשיים של נתוני המוצרים מאפשרים לנהל את ברירת המחדל כלל של מקורות נתונים. כלל ברירת המחדל הוא הכלל שחלה על כל המאפיינים במקור הנתונים. ניתן להגדיר את כלל ברירת המחדל בזמן שיוצרים את מקור נתונים או על ידי עדכון מקור נתונים קיים באמצעות כלל ברירת המחדל השדה הזה.
ההגדרה לדוגמה הבאה מבטיחה שכל המאפיינים נלקחים קודם ממקור הנתונים עם המזהה הייחודי 1001
. לאחר מכן, המאפיינים החסרים מתווספים ממקור הנתונים הראשי. בסופו של דבר, המאפיינים הנותרים יילקחו ממקור הנתונים המשלים עם המזהה הייחודי 1002
, אם הם לא יסופקו כבר במקור נתונים אחר. אם המדיניות זהה
מסופק בכמה מקורות נתונים, הערך הגבוה יותר ברשימה הוא
נבחר.
defaultRule {
takeFromDataSources: [
'1001', // Supplemental product data source
'self', // Self reference to the primary data source
'1002' // Supplemental product data source
]
}
ניהול אוטומטי של פידים
כדי לרשום את החשבון לניהול אוטומטי של מקורות הנתונים, צריך לבצע את הפעולות הבאות:
- כדי לבדוק אם החשבון עומד בדרישות להרשמה, צריך להפעיל את השיטה
accounts.autofeedSettings.getAutofeedSettings
. - מוודאים שהחשבון הוא לא חשבון בזירת מסחר.
אחרי שהחשבון יעמוד בדרישות להרשמה, תוכלו להשתמש
accounts.autofeedSettings.updateAutofeedSettings
כדי להפעיל ניהול אוטומטי של מקורות נתונים. הפעלת ההגדרה האוטומטית
ניהול מקורות נתונים מאפשר ל-Google להוסיף את המוצרים שלך באופן אוטומטי
בחנות הווירטואלית ולוודא שהם מעודכנים תמיד בפלטפורמות של Google.
אחזור סטטוס ההעלאה של קובץ
כדי לקבל את הסטטוס של מקור נתונים באמצעות קובץ, אחזור או גיליון אלקטרוני, צריך
הוא יכול לקרוא ל-method GET
של
accounts.dataSources.fileUploads
לאחר השיפור. כדי לקבל את התוצאה של האחזור האחרון של מקור הנתונים שחושב
באופן אסינכרוני כשעיבוד מקור הנתונים מסתיים, השתמשו בשם
מזהה latest
.
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
סטטוס ההעלאה של הקובץ עשוי לכלול תצוגה מפורטת של המוצרים, כולל לכל בעיה פוטנציאלית.
שימו לב: ייתכן שסטטוס העלאת הקובץ לא יופיע אם הקובץ לא הועלה אף פעם. אם תתבקשו לעשות זאת זמן קצר לאחר מכן, יכול להיות שסטטוס ההעלאה של הקובץ יהיה במצב עיבוד העלאת הקובץ.