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

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

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

עזרה

איך מקבלים עזרה בנושא Merchant API

שליחת משוב

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

  • תכונות API: בוחרים באפשרות Send Feedback בקטע What is the Issue/Question?‎ בטופס המשוב.
  • מסמכי תיעוד: אפשר להשתמש בדירוג באמצעות סימני הלייק והדיסלייק שמופיעים בדף, או ללחוץ על הכפתור Send feedback.
  • דוגמאות וספריות: דיווח על בעיה במאגר של GitHub לדוגמאות הקוד.

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

  • למידע על תאימות לדורות קודמים, עיינו במאמר תאימות של Content API for Shopping.

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

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

הבא
Merchant API terms and conditions