סקירה כללית על 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.
  • ניהול כלל ברירת המחדל של מקורות נתונים באמצעות המקורות הראשיים של נתוני המוצרים.
  • משתמשים בסוגים אחרים של מקורות נתונים, כמו קידומי מכירות.

דרישות מוקדמות

  • צריך להעביר את החשבון שלכם לפידים של שפה יחידה.

  • כדי לוודא שהחשבון כבר הועבר לחלוקת היעד של הנתונים, משתמשים רשימה של מקורות נתונים או אחזור שיטות. אם לא תהיו זכאים להטבה, תקבלו את הודעת החריגה הבאה, ועליכם לפנות לתמיכה.

    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 יכולים להיות מקורות נתונים עם תווים כלליים לחיפוש. נתונים עם תווים כלליים לחיפוש אין תמיכה במקורות לנתוני קלט של קבצים.

יצירת מקור נתונים משלים וקישור שלו למקור הנתונים הראשי

אפשר להשתמש במקורות נתונים משלימים כדי לבצע עדכונים חלקיים בנתוני המוצרים, הוספת המזהה הייחודי של מקור הנתונים כפרמטר של שאילתה כשמבצעים קריאות ל accounts.productInputs.insert וגם accounts.productInputs.delete שיטות. אפשר להשתמש במקורות נתונים משלימים רק כדי לעדכן מוצרים קיימים.

כדי ליצור מקור נתונים משלים, צריך להגדיר את מקור הנתונים באמצעות SupplementalProductDataSource ואז כדי לקשר אותו, צריך לעדכן את defaultRule במקור הנתונים הראשי.

מקורות נתונים משלימים של קבצים לא יכולים להיות מקורות נתונים עם תווים כלליים לחיפוש. API נוסף מקורות נתונים חייבים תמיד להיות מקורות נתונים עם תווים כלליים לחיפוש.

הגדרת לוח זמנים למקור הנתונים של הקובץ

כדי להגדיר תזמון לפיד הקבצים צריך להגדיר את מקור הנתונים כקובץ מקור נתונים באמצעות השדה FileInput, ואז מגדירים fetchsettings באמצעות השדה FileInput.FetchSettings.

מחיקת מקור נתונים

כדי למחוק מקור נתונים קיים מהחשבון, משתמשים ב accounts.dataSources.delete .

אחזור מקור הנתונים

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

אחזור של מקור נתונים

כדי לאחזר את ההגדרות של מקור הנתונים לחשבון, צריך להשתמש ב accounts.dataSources.get .

הצגת רשימה של מקור הנתונים

כדי להציג רשימה של מערכי ההגדרות של מקורות נתונים לחשבון שלך, אפשר להשתמש ב accounts.dataSources.list .

מקור הנתונים של התיקונים

כדי לעדכן את ההגדרות של מקור נתונים קיים, משתמשים ב 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.Get).
  • צריך לוודא שהחשבון אינו זירת מסחר חשבון.

אחרי שהחשבון יעמוד בדרישות להרשמה, תוכלו להשתמש שיטה Accounts.AutofeedSettings.Update להפעלת ניהול אוטומטי של נתונים מקורות מידע. הפעלת הניהול האוטומטי של מקורות נתונים מאפשרת ל-Google באופן אוטומטי להוסיף את המוצרים מהחנות הווירטואלית שלך ולוודא שהם תמיד מעודכנים בפלטפורמות של Google.

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

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

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

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

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