עיצבנו את Merchant API כך שיהיה מוכר למפתחים של Content API for Shopping, אבל פשוט וגמיש יותר. ריכזנו כאן מידע מפורט על העיצוב של Merchant API.
ממשקי API משניים
Merchant API הוא אוסף של ממשקי API משניים. ממשקי ה-API המשניים הם קבוצות של שירותים ומשאבים קשורים. העיצוב הזה מאפשר לכם לבחור להשתמש רק בממשקי ה-API המשניים שדרושים לשילוב הייחודי שלכם.
Merchant API כולל את ממשקי ה-API המשניים הבאים:
- חשבונות: ניהול חשבונות Merchant Center בהיקף גדול.
- המרות: ניהול מקורות המרות בחשבון.
- מקורות נתונים: כאן אפשר לראות את מקורות הנתונים של המוצרים ולנהל אותם.
- פתרון בעיות: קבלת מידע על בעיות שמשפיעות על החשבון ויצירת דף אבחון באפליקציה.
- מלאי: הצגת המוצרים שלכם ב-Google לפי חנות או אזור.
- שותפות עם פידים מקומיים: מעלים את פיד מלאי המוצרים בחנויות המקומיות.
- התראות: ניהול של מינויים לקבלת התראות.
- מעקב אחר הזמנות: כדאי לספק נתונים היסטוריים של מעקב אחר הזמנות כדי לשפר את הערכות זמני המשלוח ולהוסיף הערות על משלוח לכרטיסי המוצר.
- מוצרים: ניהול נתוני מוצרים, כמו מחיר וזמינות.
- Product Studio: אפשר להשתמש ב-Google Product Studio כדי ליצור באופן אוטומטי תמונות של מוצרים והצעות לטקסט.
- מבצעים: יצירה וניהול של מבצעים להצגת מבצעים מיוחדים על המוצרים.
- Quota: בדיקת מכסת ה-API של החשבונות.
- דוחות: אפשר לראות נתונים על המוצרים, הביצועים והסביבה התחרותית ב-Google.
- ביקורות: ניהול ביקורות על מוצרים ועל מוכרים.
תחבורה ציבורית
מנגנון התעבורה שמוגדר כברירת מחדל ב-Merchant API הוא gRPC. אפשר גם להשתמש ב-REST.
מידע נוסף זמין במדריך למתחילים.
טיפוסים בני מנייה (enum)
יכול להיות שבעתיד ייחשפו ערכים חדשים בשדות מסוג Enum ב-Merchant API. הקוד צריך להיות מובנה כך שהוא יוכל לטפל בערכים לא מזוהים בצורה חלקה. כדאי לעקוב אחרי המקרים שבהם מופיעים ערכי enum לא מזוהים ולפעול כדי שהקוד יהיה עדכני.
ניהול גרסאות
לכל API משני יש גרסה משלו. המשמעות היא שלא צריך לעשות כלום אם אנחנו מעדכנים API משני שאתם לא משתמשים בו. צריך לעדכן את הקוד רק כשמתפרסמות גרסאות חדשות של ממשקי המשנה של ה-API שבהם אתם משתמשים. מידע נוסף זמין במאמר בנושא ניהול גרסאות.
גרסאות שמסתיימות במילה beta (בטא) כפופות לשינוי או להסרה.