Formattazione di un CSV di importazione collettiva

Puoi utilizzare il metodo import per creare un set di prodotti e i prodotti con immagini di riferimento contemporaneamente utilizzando un file CSV. Questa pagina descrive come formattare il file CSV.

Creazione delle immagini di riferimento

Le immagini di riferimento sono immagini che contengono varie visualizzazioni dei tuoi prodotti. Si applicano i seguenti consigli:

  • Assicurati che le dimensioni del file non superino il limite massimo (20 MB).
  • Prendi in considerazione punti di vista che mettano in evidenza il prodotto in modo logico e contengano informazioni visive pertinenti.
  • Crea immagini di riferimento che integrino i punti di vista mancanti. Ad esempio, se hai solo immagini della scarpa destra di un paio, fornisci le versioni speculari di questi file come scarpa sinistra.
  • Carica l'immagine con la massima risoluzione disponibile.
  • Mostra il prodotto su uno sfondo bianco.
  • Converti i PNG con sfondi trasparenti in uno sfondo a tinta unita.

Le immagini devono essere archiviate in un bucket Cloud Storage. Se autentichi la chiamata di creazione dell'immagine con una chiave API, il bucket deve essere pubblico. Se l'autenticazione viene eseguita con un account di servizio, quest'ultimo deve disporre dell'accesso in lettura al bucket.

Linee guida per la formattazione CSV

Per utilizzare il metodo import, sia il file CSV sia le immagini a cui fa riferimento devono trovarsi in un bucket Cloud Storage. I file CSV sono limitati a un massimo di 20.000 righe; ogni riga è limitata a un massimo di 2048 caratteri. Per importare più immagini, suddividile in più file CSV.

Il file CSV deve contenere un'immagine per riga e le seguenti colonne:

  1. image-uri: l'URI Cloud Storage dell'immagine di riferimento.
  2. image-id: facoltativo. Un valore univoco, se lo fornisci. In caso contrario, il sistema assegnerà un valore univoco.
  3. product-set-id: un identificatore univoco per il set di prodotti in cui importare le immagini.

  4. product-id: un ID definito dall'utente per il prodotto identificato dall'immagine di riferimento. Un product-id può essere associato a più immagini di riferimento.

  5. product-category: i valori consentiti sono homegoods-v2, apparel-v2, toys-v2, packagedgoods-v1, e general-v1 *; la categoria del prodotto identificato dall'immagine di riferimento. Deducibile dal sistema se non specificato nella richiesta di creazione. I valori consentiti sono elencati anche nella productCategory documentazione di riferimento.

  6. product-display-name: facoltativo. Se non fornisci un nome per il prodotto, displayName verrà impostato su " ". Puoi aggiornare questo valore in un secondo momento.

  7. labels: facoltativo. Una stringa (con virgolette) di coppie chiave-valore che descrivono i prodotti nell'immagine di riferimento. Ad esempio:

    • "category=shoes"

    • "color=black,style=formal"

      Vision API Product Search ti consente anche di fornire più valori per una singola chiave. Ad esempio:

    • "category=shoes,category=heels"

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

  8. bounding-poly: facoltativo. Specifica l'area di interesse nell'immagine di riferimento. Se non viene specificato un riquadro di delimitazione:

    1. I riquadri di delimitazione per l'immagine vengono dedotti dall'API Vision; più regioni in una singola immagine possono essere indicizzate se l'API rileva più prodotti.
    2. La riga deve terminare con una virgola.

    Vedi l'esempio riportato di seguito per un prodotto senza un poligono di delimitazione specificato.

    Se includi un riquadro di delimitazione, la colonna boundingPoly deve contenere un numero pari di numeri separati da virgole, con il formato p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. Una riga di esempio è la seguente: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

    Per definire un riquadro di delimitazione con i valori dei pixel effettivi dell'immagine, utilizza numeri interi non negativi. Pertanto, potresti esprimere i riquadri di selezione in immagini di 1000 pixel per 1000 pixel nel seguente modo:

    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 ti consente anche di utilizzare valori normalizzati per i riquadri di selezione. Definisci un riquadro di delimitazione utilizzando valori normalizzati con valori float in [0, 1].

    Utilizzando valori normalizzati, le righe dell'immagine di riferimento riportate sopra potrebbero anche essere espresse come segue:

    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,,,