סקירה כללית על 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. יוצרים את הקישור באמצעות קריאה לשיטת הרישום למפתחים. החשבון הזה והמשתמשים האלה ישמשו לתקשורת בנוגע לשילוב ה-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