עיצוב של קובץ 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"

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

    • "category=shoes,category=heels"

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

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

    1. ה-API של Vision מסיק את תיבות התוחמות של התמונה. יכול להיות שמספר אזורים בתמונה אחת יתווספו לאינדקס אם ה-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,000x1,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 Google 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,,,