תחילת השימוש ב-Merchant API

כדי להתחיל, מפעילים את 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
  1. יצירת גוף הבקשה כמאגר לפרוטוקולים.
  2. שולחים את גוף הבקשה לשרת באמצעות HTTP/2.
  3. ביצוע דה-סריאליזציה של התגובה למאגר פרוטוקול.
  4. פרש את התוצאות.
  1. יוצרים את גוף הבקשה כאובייקט JSON.
  2. שולחים אותו לשרת באמצעות HTTP 1.1.
  3. מבצעים דה-סריאליזציה של התגובה כאובייקט JSON.
  4. פרש את התוצאות.

עזרה

למידע על קבלת תמיכה, קראו את המאמר קבלת עזרה בנושא Merchant API.

שליחת משוב

תקופת הבטא מאפשרת לנו לאסוף את המשוב שלכם ולטפל בו לפני השקת הגרסה הזמינה לכולם. כדי לשלוח משוב, אפשר לשלוח את אחד מהמסמכים הבאים:

  • תכונות API: שליחת טופס המשוב
  • תיעוד: שימוש בדירוג 'אהבתי' בדף ושליחת משוב לחצן.
  • דוגמאות וספריות:לוחצים על הלחצן New issue (בעיה חדשה) ב-GitHub.

כדי לשלוח משוב כללי אחרי הטמעת כל משימה, אפשר להשתמש בטופס המשוב.