עיצוב של קובץ CSV לייבוא בכמות גדולה

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

יצירת התמונות לדוגמה

תמונות לדוגמה הן תמונות שמכילות תצוגות שונות של המוצרים שלכם. ההמלצות הבאות רלוונטיות:

  • צריך לוודא שהקובץ לא חורג מהגודל המקסימלי (20MB).
  • כדאי לבחור נקודות מבט שמציגות את המוצר בצורה הגיונית ומכילות מידע חזותי רלוונטי.
  • יוצרים תמונות לדוגמה שמשלימות נקודות מבט חסרות. לדוגמה, אם יש לכם רק תמונות של הנעל הימנית מתוך זוג, אתם יכולים לספק גרסאות הפוכות של הקבצים האלה בתור הנעל השמאלית.
  • מעלים את התמונה ברזולוציה הגבוהה ביותר שזמינה.
  • המוצר מוצג על רקע לבן.
  • המרת קובצי PNG עם רקע שקוף לרקע אחיד.

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

הנחיות לגבי פורמט CSV

כדי להשתמש בשיטה import, קובץ ה-CSV וגם התמונות שהוא מפנה אליהן צריכים להיות בקטגוריה של Cloud Storage. קובצי CSV מוגבלים ל-20,000 שורות לכל היותר, וכל שורה מוגבלת ל-2,048 תווים לכל היותר. כדי לייבא עוד תמונות, צריך לפצל אותן לכמה קובצי CSV.

קובץ ה-CSV צריך להכיל תמונה אחת בכל שורה, ואת העמודות הבאות:

  1. ‫image-uri: ה-URI של תמונת ההפניה ב-Cloud Storage.
  2. ‫image-id: אופציונלי. ערך ייחודי אם מספקים אותו. אחרת, המערכת תקצה ערך ייחודי.
  3. ‫product-set-id: מזהה ייחודי של קבוצת המוצרים שאליה רוצים לייבא את התמונות.

  4. ‫product-id: מזהה שהוגדר על ידי המשתמש למוצר שמזוהה על ידי תמונת ההפניה. אפשר לשייך product-id לכמה תמונות לדוגמה.

  5. ‫product-category: הערכים המותרים הם homegoods-v2,‏ apparel-v2,‏ toys-v2,‏ packagedgoods-v1 ו-general-v1*; הקטגוריה של המוצר שמזוהה על ידי תמונת ההפניה. המערכת מסיקה את הערך הזה אם הוא לא מצוין בבקשת היצירה. הערכים המותרים מפורטים גם במסמכי העזר בנושא productCategory.

  6. ‫product-display-name: אופציונלי. אם לא תציינו שם למוצר, הערך של displayName יהיה ' '. תוכלו לעדכן את הערך הזה בהמשך.

  7. ‫labels: אופציונלי. מחרוזת (עם מרכאות) של צמדי מפתח/ערך שמתארים את המוצרים בתמונת ההפניה. לדוגמה:

    • "category=shoes"

    • "color=black,style=formal"

      ב-Vision API Google Product Search אפשר גם לספק כמה ערכים למפתח יחיד. לדוגמה:

    • "category=shoes,category=heels"

    • "color=black,style=formal,style=mens"

  8. ‫bounding-poly: אופציונלי. מציין את אזור העניין בתמונת ההפניה. אם לא מציינים תיבה תוחמת:

    1. ה-Cloud Vision API מסיק את תיבות התוחמות של התמונה. יכול להיות שמספר אזורים בתמונה אחת יתווספו לאינדקס אם ה-API יזהה כמה מוצרים.
    2. השורה חייבת להסתיים בפסיק.

    בדוגמה הבאה מוצג מוצר ללא פוליגון תיחום.

    אם כוללים תיבת תוחמת, העמודה boundingPoly צריכה להכיל מספר זוגי של מספרים מופרדים בפסיקים, בפורמט p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. דוגמה לשורה: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

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

    gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",100,150,450,150,450,550,100,550
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",670,790,980,790,980,920,670,920
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,

    מערכת Vision API Product Search מאפשרת גם להשתמש בערכים מנורמלים עבור תיבות תוחמות. מגדירים תיבת תוחמת באמצעות ערכים מנורמלים עם ערכי float בטווח [0, 1].

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

    gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",0.10,0.15,0.45,0.15,0.45,0.55,0.10,0.55
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",0.67,0.79,0.98,0.79,0.98,0.92,0.67,0.92
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,