כדי להתחיל, מפעילים את Merchant API בפרויקט ב-Cloud.
כך משתמשים ב-Merchant API:
שימוש בספריות לקוח
Merchant API מורכב מכמה ממשקי API משניים.
לכל ממשק API משני יש דוגמאות קוד וספריות לקוח שיעזרו לכם להתחיל.
אם אתם כבר משתמשים ב-Content API for Shopping, תוכלו לעיין במאמר תאימות של Content API for Shopping.
שליחת בקשות
ב-Merchant API נעשה שימוש בשמות משאבים במקום במזהים לצורך זיהוי. דוגמה לשם משאב של מוצר יכולה להיות accounts/123/products/online~en~US~sku123, כאשר 123 הוא המזהה הייחודי של החשבון ו-online~en~US~sku123 הוא המזהה הייחודי של המוצר.
כדי לבצע פעולות במשאב, שולחים בקשות לכתובות URL בפורמט הבא:
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
לדוגמה, הבקשה הזו תמחק את מלאי שטחי הפרסום האזורי:
DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456
כדי ליצור משאב חדש, אפשר להשתמש בשם המשאב של משאב ההורה ובכתובת ה-URL הבאה:
POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}
לדוגמה, כך יוצרים אזור חדש עבור account/123
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions
מידע נוסף על שירותים ספציפיים זמין במסמכי העזרה של Merchant API.
שימוש ב-gRPC או ב-REST
Merchant API תומך ב-gRPC וב-REST. אלה שתי הדרכים לבצע קריאות ל-Merchant API:
| gRPC (מומלץ) | REST |
|---|---|
|
|
עזרה
למידע על קבלת תמיכה, קראו את המאמר קבלת עזרה בנושא Merchant API.
שליחת משוב
תקופת הבטא מאפשרת לנו לאסוף את המשוב שלכם ולטפל בו לפני השקת הגרסה הזמינה לכולם. כדי לשלוח משוב, אפשר לשלוח את אחד מהמסמכים הבאים:
- תכונות API: שליחת טופס המשוב
- מסמכי עזרה: אתם יכולים להשתמש בלחצן שליחת משוב ובסמלי הדירוג בדף.
- דוגמאות וספריות: משתמשים בלחצן New issue ב-GitHub.
כדי לשלוח משוב כללי אחרי הטמעת כל משימה, אפשר להשתמש בטופס המשוב.