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

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

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

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

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

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

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

מה חדש ב-Merchant API

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

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

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

  • חשבון 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"
  }
}

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

איך מתחילים להשתמש ב-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