סקירה כללית על Merchant API

אפשר להשתמש ב-Merchant API כדי

  • לנהל את האופן שבו העסק והמוצרים שלכם מופיעים ב-Google.
  • גישה פרוגרמטית לנתונים, לתובנות וליכולות ייחודיות.
  • מרחיבים את העסק ומגיעים ליותר לקוחות ב-Google.

‫Merchant API יכול לנהל חשבונות Merchant Center גדולים או מורכבים. תרחישים נפוצים לדוגמה:

  • ניהול חשבונות אוטומטי
  • ניהול מוצרים אוטומטי
  • ניהול מלאי שטחי פרסום אוטומטי
  • ניהול אוטומטי של דוחות על ביצועים ותובנות לגבי השוק

‫Merchant API מאפשר לכם ליצור ולנהל כמה מקורות נתונים, וכך לארגן באופן משופר את המידע על המוצרים, המבצעים והביקורות. באמצעות Merchant API תוכלו לנהל את המוצרים באופן שמשלים שיטות אחרות להעלאת נתוני מוצרים, כמו קבצים ופיד אוטומטי. עם Merchant API תוכלו גם להריץ במקביל כמה בקשות נפרדות.

‫Merchant API הוא עיצוב מחדש של Content API for Shopping. הוא כולל כמה ממשקי API משניים.

מה חדש ב-Merchant API

ריכזנו כאן כמה סיבות לשדרוג ל-Merchant API:

לפני שמתחילים

כדי להריץ בקשה של Merchant API, אתם צריכים:

  • חשבון Merchant Center: לחשבון הזה תשלחו שאילתות ותעלו נתונים, וגם תבצעו בו עדכונים. ודאו שיש לכם את ההרשאות הנדרשות כדי לנהל מוצרים ורשימות מלאי בחשבון הזה.

  • פרויקט Google Cloud: באמצעותו יש גישה ל-API מהחשבון שלכם.

  • קישור מחשבון Merchant Center לפרויקט Google Cloud. יוצרים את הקישור באמצעות הפעלת השיטה Developer Registration. החשבון הזה והמשתמשים האלה ישמשו לתקשורת בנוגע לשילוב ה-API, לסקרים ולהזדמנויות.

  • כדי לקשר את חשבון Merchant Center לפרויקט Google Cloud, צריך להירשם כמפתח. המשתמשים עם התפקיד 'מפתח API' יקבלו הודעות שקשורות ל-API, כולל עדכונים חיוניים בנוגע לשירות, סקרים שמכוונים למפתחים והודעות על הזדמנויות.

אימות באמצעות Merchant API

אפשר להשתמש באפשרויות האימות הבאות:

  • אפשר ליצור מזהה לקוח וסוד לקוח של OAuth 2.0 לאפליקציה. לאחר מכן אפשר להשתמש במזהה ובסוד כדי ליצור את פרטי הכניסה של OAuth 2.0 שנדרשים לקריאות API לחשבון Merchant Center.
  • אתם יכולים ליצור חשבון שירות ולהוריד את המפתח הפרטי שלו כדי לבצע קריאות ל-API.

מזהי חשבונות ומוצרים

ב-Merchant API נעשה שימוש בשמות משאבים במקום במזהים לצורך זיהוי. דוגמה לשם משאב של מוצר: accounts/123456/products/en~US~sku123, כאשר 123456 הוא המזהה הייחודי של החשבון ו-en~US~sku123 הוא המזהה הייחודי של המוצר.

הפורמט של כתובת ה-URL של הבקשה

כדי לבצע פעולה במשאב, שולחים בקשות לכתובות URL בפורמט הבא:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

החלק :{METHOD} מושמט בשיטות רגילות כמו list ו-get.

לדוגמה, הבקשה הבאה מוחקת את המלאי האזורי:

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/online~en~US~sku123/regionalInventories/456

כדי ליצור משאב, משתמשים בשם המשאב של משאב האב ובכתובת ה-URL הזו:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

לדוגמה, הבקשה הבאה מראה איך יוצרים אזור בשביל accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

פרטים נוספים על שירותים ספציפיים זמינים במסמכי התיעוד של Merchant API.

איך מתחילים להשתמש ב-Merchant API

כדי לראות במהירות איך Merchant API עובד ולנסות להעלות מוצר לדוגמה, אפשר לעיין במאמר איך מתחילים להשתמש ב-Merchant API.

שימוש ב-gRPC או ב-REST

‫Merchant API תומך ב-gRPC וב-REST. יש שתי דרכים לשלוח קריאות ל-Merchant API:

gRPC (מומלץ) REST
  1. יוצרים את גוף הבקשה כמאגר פרוטוקולים.
  2. שליחת גוף הבקשה לשרת באמצעות HTTP/2.
  3. מבטלים את הסריאליזציה של התגובה ל-Protocol Buffer.
  4. פרש את התוצאות.
  1. יוצרים את תוכן הבקשה כאובייקט JSON.
  2. שולחים אותו לשרת באמצעות HTTP 1.1.
  3. מבטלים את הסריאליזציה של התגובה כאובייקט JSON.
  4. פרש את התוצאות.

שימוש בספריות לקוח ובדוגמאות קוד

לכל API משני יש ספריות לקוח שיעזרו לכם להתחיל. דוגמאות קוד יכולות לעזור לכם להתחיל לכתוב קוד ב-Java, ב-PHP וב-Python. מידע נוסף זמין במאמר דוגמאות ל-Merchant API.

עזרה

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

שליחת משוב

כדי לשלוח משוב, אפשר לשלוח את אחד מהפריטים הבאים:

  • תכונות API: בוחרים באפשרות שליחת משוב בקטע מה הבעיה או השאלה? בטופס המשוב.
  • מסמכי תיעוד: אפשר להשתמש בדירוג באמצעות סימני לייק ודיסלייק בדף ובכפתור שליחת משוב.
  • דוגמאות וספריות: יוצרים בקשה לבעיה במאגר GitHub של דוגמאות הקוד.

המאמרים הבאים

  • מידע על תאימות לאחור זמין במאמר תאימות של Content API for Shopping.

  • כדי לקבל מידע נוסף על התכונות העיקריות של Merchant API, אפשר לעיין במדריכים בתפריט הניווט הימני.

  • במאמרי העזרה מוסבר על המשאבים והשירותים הזמינים.

הקודם
Latest updates
הבא
Design