סקירה כללית על 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:

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

כדי להריץ בקשת 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"
  }
}

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

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

הבא
Terms and Conditions