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

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

הבא
Merchant API terms and conditions