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

בדף הזה נספק מבוא ל-Merchant API ונסביר איך אפשר להשתמש בו כדי לבצע אוטומציה של תהליכי עבודה שונים שקשורים לניהול חשבונות, מוצרים ומלאי שטחי פרסום ב-Merchant Center.

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

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

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

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

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

מה חדש ב-Merchant API

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

מידע נוסף זמין במאמר תכונות חדשות שנוספו ל-Merchant API Beta.

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

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

  • חשבון Merchant Center: זהו החשבון שבו תבצעו שאילתות, עדכונים והעלאות של נתונים. חשוב לוודא שיש לכם את ההרשאות הדרושות לניהול מוצרים ומלאי בחשבון הזה.

  • פרויקט ב-Google Cloud: הפרויקט משמש לקבלת גישה ל-API לחשבון שלכם.

אימות באמצעות Merchant API

אפשר להשתמש באפשרויות הבאות לאימות:

  • אתם יכולים ליצור מזהה לקוח וסוד לקוח של OAuth 2.0 לאפליקציה. לאחר מכן תוכלו להשתמש במזהה ובסוד כדי ליצור את פרטי הכניסה של OAuth 2.0 שנדרשים בקריאות API לחשבון Merchant Center.
  • אפשר ליצור חשבון שירות ולהוריד את המפתח הפרטי שלו כדי לבצע קריאות ל-API.

מזהי חשבונות ומוצרים

ב-Merchant API נעשה שימוש בשמות משאבים במקום במזהים לצורך זיהוי. דוגמה לשם משאב של מוצר יכולה להיות accounts/123456/products/online~en~US~sku123, כאשר 123456 הוא המזהה הייחודי של החשבון ו-online~en~US~sku123 הוא המזהה הייחודי של המוצר.

הפורמט של כתובת ה-URL בבקשה

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

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

החלק :{METHOD} מושמט בשיטות רגילות כמו list ו-get.

לדוגמה, הבקשה הבאה מוחקת את מלאי שטחי הפרסום האזורי:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/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/v1beta/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: שליחת טופס המשוב
  • מסמכי עזרה: אתם יכולים להשתמש בלחצן שליחת משוב ובסמלי הדירוג בדף.
  • דוגמאות וספריות: יוצרים דיווח על בעיה במאגר GitHub של דוגמאות הקוד.

כדי לשלוח משוב כללי אחרי הטמעת כל משימה, אפשר להשתמש בטופס המשוב.

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

  • מידע על תאימות לאחור זמין במאמר תאימות של Content API for Shopping.

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

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

הבא
Design