API

---

אימות

כדי להשתמש ב-Merchant API for Shopping בחשבון Merchant Center נתון: חייבים להגדיר פרויקט API Console. עזרה לגבי פרויקטים במסוף Google Cloud כדי לנהל את הגישה ל-API ואת האימות שלהם בפתרון Merchant API.

יש שתי דרכים לגשת ל-Merchant API בהתאם לתרחיש לדוגמה הרלוונטי:

• כדי לקבל גישה לחשבון Merchant Center ספציפי, מומלץ להשתמש ב-OAuth 2.0 דרך אפליקציה שפיתחתם עבור המשתמשים. המשתמש יצטרך צריכים להעניק למשתמשים גישה לחשבון כדי לשלוח נתונים בשמם.
• חשבון שירות הוא סוג מיוחד של חשבון, שבדרך כלל משתמשים בו יישום בפועל, ולא אדם. חשבון השירות מזוהה לפי כתובת האימייל שלו הייחודית לחשבון.

כדאי לקרוא איך מבצעים אימות באמצעות OAuth 2.0 או שירות חשבון.

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

הפעלת הגדרות המדינה

חשוב: לפני ששולחים את המוצרים שנדרשים כדי להפעיל את התוכנית.

צריך להתקשר למספר liasettings.update כדי לציין את המדינות שבהן להציג מודעות באופן מקומי.

מידע נוסף זמין בדף הטירגוט של הגדרות המדינה

שליחת נתוני מבצעים

יש שני סוגים של נתונים: נתוני מוצרים ונתוני מלאי.

שליחת נתוני מוצרים ומלאי בו-זמנית

אפשר לשלוח נתוני מוצרים ונתוני מלאי בבת אחת באמצעות accounts.lfpInventories.insert

השדה 'מספר GTIN' בפועל יפעל כמזהה מוצר בקטלוג של Google ופיד מוצרים ייווצר באופן אוטומטי.

הפיד שנוצר באופן אוטומטי יופיע ב-Merchant Center בתור 'ספק פיד מקומי' בפיד עם המוצרים הרלוונטיים שמשויכים אליהם.

השיטה הזו פועלת היטב אם לכל המוצרים של המוכר יש מספר GTIN ואין עוד יופעלו תכונות מסוימות (כמו 'דף של חנות מקומית באתר של המוכר' בסיסי). אם אתם מתכננים להפעיל את האפשרות MHLSF עבור המוֹכרים שלכם, אתם צריכים לשלוח פיד מוצרים ייעודי למוֹכרים. היא ההגדרה המומלצת.

ניתן לבצע את אותו תהליך באמצעות accounts.lfpSales.insert

במקרה זה הנתונים מתייחסים לאירוע מבצע עבור מוצר מסוים זמן מסוים.

שולחים נתוני מוצרים ונתוני מלאי בנפרד

אם מספרי GTIN אינם זמינים לכולם או שאתם מעדיפים להשתמש שכבר קיים בחשבון היעד ב-Merchant Center, או שרוצים להפעיל MHLSF בשביל המוֹכרים שלכם, צריך להיות לכם פיד מוצרים ספציפי של חנויות מקומיות.

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

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

זרימת הנתונים היא:

• כדי להתחיל להעלות, צריך להתקשר קודם אל accounts.productInputs.insert מוצרים למוכרים
• לאחר מכן, אפשר להתקשר אל accounts.lfpInventories.insert כדי לשלוח את המלאי .

לחלופין, אפשר לשלוח נתוני מלאי דרך accounts.lfpSales.insert. לאחר מכן מודל למידת מכונה לחזות את המחיר והכמות של המוצרים על סמך הנתונים האלה.

סקירה כללית לדוגמה עבור accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

חשוב: מזהה ה-OfferId שנשלח ב-accounts.productInputs.insert צריך תואם למזהה OfferId ב-accounts.lfpInventories.insert המוצרים ממופים כראוי.

חשוב: בחשבון accounts.lfpInventories.insert יש הורה בכתובת האתר. זהו חשבון ספק LFP שלך שמופעל על ידי צוות התמיכה. חשבון Merchant Center של הקמעונאי שלך נמצא במטען הייעודי (payload) של הבקשה מזוהה במקום זאת כ-TargetMerchant. זהו מספר חשבון Merchant Center של המוכר לשלוח את המלאי עבורו.

נקודה חשובה: התוקף של נתוני המוצרים יפוג תוך 30 יום, ונתוני המלאי יפוגו אחרי 14. ימים. האפשרות הזו יעילה בהסרה של מוצרים לא רצויים. מוצר ומלאי אפשר לשלוח נתונים בבת אחת באמצעות accounts.lfpInventories.insert אם מספרי GTIN ידועים לכל המוצרים. לחלופין, אפשר להשתמש ב- accounts.productInputs.insert לנתוני המוצרים וגם accounts.lfpInventories.insert (או accounts.lfpSales.insert) לנתוני מלאי

שליחת הנתונים של פרופיל העסק

כשאין אפשרות לגשת לחשבון 'פרופיל העסק ב-Google' של המוכר כדי לאחזר את קודי החנויות, ניתן לשלוח נתוני חנות accounts.lfpStores.insert עם קודי חנויות ספציפיים משלכם.

הערה: כשמתקשרים ל-accounts.lfpinventories.insert או accounts.lfpSales.insert צריך להיות זהה לקוד החנות סופקו בבקשות מ-lfp Stores.

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

התגובה של accounts.lfpStores.insert תספק גם matchingState ו-matchingStateHint אם ההתאמה נכשלה.

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