ניהול פרטי הקטלוג

בדף הזה מוסבר איך לנהל את פרטי המוצרים אחרי שמייבאים קטלוג ל-AI Commerce Search. אתם יכולים לקרוא מוצרים בקטלוג, לכתוב מוצרים ולמחוק אותם.

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

יצירה, גישה וניהול של מדריכים למוצרים

במדריך הזה מוסבר איך להשתמש בשיטות של API, שמבצעות את הפעולות הבאות:

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

יצירת מוצר

במדריך הזה מוסבר איך ליצור מוצר בודד.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

קבלת מוצר

במדריך הזה מוסבר איך לאחזר פריט מוצר.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

עדכון מוצר

במדריך הזה מוסבר איך לעדכן מוצר בקטלוג.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

מחיקת מוצר

במדריך הזה מוסבר איך למחוק מוצר מקטלוג.

בלחיצה על תראו לי איך תקבלו הסבר מפורט על המשימה ישירות ב-Cloud Shell Editor:

תראו לי איך

העלאת פריט מוצר בודד

curl

יוצרים פריט מוצר יחיד באמצעות שיטת ה-REST‏ products.create.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
      "title": "PRODUCT_TITLE",
      "categories": "CATEGORY"
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productId=PRODUCT_ID"

אם הבקשה מצליחה, מוחזר אובייקט המוצר, כמו בדוגמה הבאה.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": \[
    "CATEGORY"
  \],
  "title": "PRODUCT_TITLE",
  "availability": "IN_STOCK"
}

Java

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

עדכון פרטי המוצר

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

curl

מעדכנים את פרטי המוצר באמצעות ה-method‏ products.patch.

בדוגמה הבאה מעדכנים את שם המוצר של מוצר ספציפי:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
       "title": "new-title-value"
    }" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"

אם הבקשה מצליחה, מוחזר אובייקט המוצר, כמו בדוגמה הבאה.

{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID",
  "id": "PRODUCT_ID",
  "primaryProductId": "PRODUCT_ID",
  "type": "PRIMARY",
  "categories": \[
    "Parent category > Child category"
  \],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Java

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

מחיקת פרטי המוצר

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

מומלץ להגדיר את availability של מוצרים שיצאו משימוש כ-OUT_OF_STOCK במקום למחוק אותם.

curl

כדי למחוק מוצר, משתמשים בשיטה delete ומחליפים את PRODUCT_ID במזהה של המוצר שרוצים למחוק.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

Java

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

אחזור פריט מוצר

curl

כדי לאחזר פריט מוצר, שולחים בקשת GET לנקודת הקצה products ומחליפים את PRODUCT_ID במזהה של המוצר שרוצים לאחזר:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"  \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"

הפלט אמור להיראות כך:

{
    "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
    "id": "PRODUCT_ID",
    "primaryProductId": "PRODUCT_ID",
    "type": "PRIMARY",
    "categories": \[
      "Parent category > Child category"
    \],
    "title": "product title",
    "availability": "IN_STOCK"
}

Java

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

הצגת מידע מצטבר על הקטלוג

בכרטיסייה קטלוג בדף נתונים במסוף של AI Commerce Search ב-Gemini Enterprise for Customer Experience אפשר לראות מידע מצטבר על הקטלוג ולצפות בתצוגה מקדימה של מוצרים שהועלו.

הערכת איכות הנתונים בקטלוג

כדי להעריך את איכות הנתונים בקטלוג:

  1. עוברים לדף איכות הנתונים במסוף של AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף 'איכות הנתונים'

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

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

במאמר הזה מפורטים מדדי האיכות של הקטלוג.

שינוי סוגי המוצרים

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

סוג המוצר יכול להיות TYPE_UNSPECIFIED, PRIMARY, VARIANT או COLLECTION. פרטים נוספים מופיעים בproduct.Type במאמרי העזרה.

שינוי ההגדרות ברמת המוצר

כדי לייבא קטלוג באמצעות Merchant Center, צריך לציין אם המוצרים הם מוצרים ראשיים או וריאנטים.

אם יש שינוי ברמות המוצר או שהן צוינו בצורה שגויה, צריך לפעול לפי השלבים הבאים כדי לתקן את ההגדרה שלהן. כדי להשלים את התהליך הזה, צריך להיות לכם תפקיד אדמין של Retail ב-IAM.

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

  2. מחיקה של כל פריטי המוצרים. מידע נוסף מפורט בproducts.delete. לפני שממשיכים לשלב הבא, צריך לוודא שהקטלוג ריק לגמרי.

  3. כדי לשנות את ההגדרה ברמת המוצר, צריך לייבא מחדש את הנתונים.

    התהליך הזה תלוי בשיטת הייבוא. פועלים לפי ההליך המתאים במאמר ייבוא פרטי קטלוג כדי להגדיר את רמות המוצרים בהתאם להגדרה החדשה.

  4. מייבאים את הקטלוג החדש עם הגדרת הרמה ששונתה, באמצעות ההליך שבחרתם במאמר ייבוא פרטי קטלוג.

  5. שיפור הביצועים של כל המודלים הקיימים.

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

    לדף Models

    פרטים על עלויות ההתאמה זמינים במאמר בנושא תמחור.