איך מתחילים לעבוד עם שירותי השוואת מחירים (CSS)

דרך טובה להתחיל להשתמש ב-API היא לבצע פעולות בסיסיות.

דרישות מוקדמות

לפני שמתחילים, צריך לבצע את הפעולות הבאות:

  • מוודאים שיש לכם חשבון תקף ב-CSS Center.
  • רושמים מפתח API.
  • מוודאים שהגדרת ההרשאות נכונה.
  • מוודאים שהפעלתם את CSS API.
  • מוודאים שהתקנתם את ספריות הלקוח בסביבה שלכם.

מידע נוסף זמין במאמר מדריך למתחילים.

הפעלת CSS API

כדי להירשם כמפתח ולהשתמש ב-CSS API, צריך לקשר את החשבון שלכם ב-CSS Center ואת הפרויקט שלכם ב-Google Cloud באמצעות שיטת הרישום למפתחים, באופן הבא:

קישור CSS Center לפרויקט ב-Google Cloud: הקישור נוצר באופן אוטומטי, כי למבצע הקריאה החוזרת (caller) יש גישה לפרויקט ב-Google Cloud על סמך אסימון הגישה או מפתח ה-API, והוא משתמש מורשה בחשבון CSS Center.

רישום מפתח API

הוספת משתמש מפתח API לחשבון CSS Center: אם המשתמש כבר קיים, פשוט תוענק לו גישה מסוג 'מפתח API' חדש. במקרה של משתמש חדש, הוא מקבל הזמנה באימייל ל-CSS Center.

אחרי הרישום אפשר לראות את סטטוס הרישום באמצעות GetDeveloperRegistration או לבטל את הרישום באמצעות UnregisterGCP. אפשר להשתמש בקריאה הבאה לרישום:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
      developer_email:"example-email@example.com"
}

אחרי שהבקשה תפעל בהצלחה, תקבלו את התגובה:

{
      "developerRegistration":
{
            "name": "accounts/ACCOUNT_ID/developerRegistration",
           "gcpIds": [
            "GOOGLE_CLOUD_PROJECT_ID"
        ]
    }
}

מוצרים בשירות CSS

בדומה ל-API המשני Products, ‏ CSS API מבחין בין CssProductInput לבין ListCssProduct. הוספת מוצר עם InsertCssProductInput.

אחרי שהמערכות הפנימיות שלנו יעבדו את המוצר (התהליך הזה יכול להימשך כמה דקות), אפשר לאחזר אותו באמצעות ListCssProducts.

מזהים את המוצרים באמצעות raw_provided_id. מומלץ להשתמש במזהה שכבר נמצא בשימוש במערכת שלכם. לחלופין, אפשר ליצור אותו באמצעות אחת מהשיטות הנפוצות הבאות:

  • מזהים ייחודיים גלובליים (GUID)
  • מזהים ייחודיים אוניברסליים (UUID)
  • מאפייני מוצר ייחודיים משורשרים (לדוגמה, brand_model_color_size)

מידע נוסף זמין במאמר בנושא הוספה, הצגה, עדכון או מחיקה של מוצר.

פעולות בסיסיות

הנה כמה בקשות בסיסיות שאפשר לנסות.

  1. מוסיפים מוצר בדיקה באמצעות InsertCssProductInput. כדי לקבל עזרה בנוגע למאפיינים שצריך לשלוח, אפשר לעיין בקוד לדוגמה.

  2. הצגת רשימה של כל המוצרים באמצעות ListCssProducts. שימו לב: יש עיכוב קל בעיבוד בין הוספת מוצר לבין הופעתו בכרטיס המוצר. אם לא מופיעה אפשרות כזו מיד, כדאי לנסות שוב אחרי כמה שניות.

  3. עדכון של מוצר יחיד באמצעות UpdateCssProductInput באמצעות cssproductinput.name. צריך לשלוח רק את המאפיינים שרוצים לעדכן. דוגמה אפשר לראות בקוד לדוגמה.

  4. מוחקים את מוצר הבדיקה באמצעות DeleteCssProductInpu ומזינים את raw_provided_id.

מגבלות

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

הצגת רשימה של החשבונות והוספת תוויות

התכונה 'ניהול תוויות' ב-CSS API מאפשרת לכם לארגן באופן פרוגרמטי את חשבונות Merchant Center של הלקוחות באמצעות תגים בהתאמה אישית. התכונה הזו עוזרת לכם לסווג את הלקוחות בצורה יעילה (למשל, לפי סוג או אסטרטגיה), וכך לשפר את הארגון ולייעל את הפעולות. אפשר להשתמש ב-API כדי לבצע את הפעולות הבאות על תוויות: