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