עיצבנו את 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 המשניים שבהם אתם משתמשים. מידע נוסף זמין במאמר ניהול גרסאות.