סקירה כללית על API של מקורות נתונים ל-Merchant

בדף הזה מוסבר איך ליצור ולעדכן באופן פרוגרמטי מקורות נתונים מאפשרות להוסיף מוצרים. מקורות נתונים אוטומטיים מאפשרים לשלוח בקלות את נתוני המוצרים שלכם ל-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.updateAutofeedSettings כדי להפעיל ניהול אוטומטי של מקורות נתונים. הפעלת ההגדרה האוטומטית ניהול מקורות נתונים מאפשר ל-Google להוסיף את המוצרים שלך באופן אוטומטי בחנות הווירטואלית ולוודא שהם מעודכנים תמיד בפלטפורמות של Google.

אחזור סטטוס ההעלאה של קובץ

כדי לקבל את הסטטוס של מקור נתונים באמצעות קובץ, אחזור או גיליון אלקטרוני, צריך הוא יכול לקרוא ל-method GET של accounts.dataSources.fileUploads לאחר השיפור. כדי לקבל את התוצאה של האחזור האחרון של מקור הנתונים שחושב באופן אסינכרוני כשעיבוד מקור הנתונים מסתיים, השתמשו בשם מזהה latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

סטטוס ההעלאה של הקובץ עשוי לכלול תצוגה מפורטת של המוצרים, כולל לכל בעיה פוטנציאלית.

שימו לב: ייתכן שסטטוס העלאת הקובץ לא יופיע אם הקובץ לא הועלה אף פעם. אם תתבקשו לעשות זאת זמן קצר לאחר מכן, יכול להיות שסטטוס ההעלאה של הקובץ יהיה במצב עיבוד העלאת הקובץ.