Formattazione di un CSV di importazione collettiva

Puoi utilizzare il metodo import per creare contemporaneamente un set di prodotti e prodotti con immagini di riferimento utilizzando un file CSV. In questa pagina viene descritto come formattare il file CSV.

Creazione delle immagini di riferimento

Le immagini di riferimento sono immagini contenenti diverse viste dei prodotti. Si applicano i seguenti consigli:

  • Assicurati che le dimensioni del file non superino la dimensione massima (20 MB).
  • Considera i punti di vista che evidenziano logicamente il prodotto e contengono informazioni visive pertinenti.
  • Crea immagini di riferimento che completino i punti di vista mancanti. Ad esempio, se hai solo immagini della scarpa destra in una coppia, fornisci 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 file PNG con sfondi trasparenti in uno sfondo a tinta unita.

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

Linee guida per la formattazione dei file CSV

Per utilizzare il metodo import, sia il file CSV sia le immagini a cui rimanda devono essere in un bucket Cloud Storage. I file CSV hanno un limite massimo di 20.000 righe e ogni riga ha un limite massimo di 2048 caratteri. Per importare altre immagini, suddividile in più file CSV.

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

  1. image-uri: l'URI Cloud Storage dell'immagine di riferimento.
  2. image-id: facoltativo. Un valore univoco, se fornito. In caso contrario, il sistema assegnerà un valore univoco.
  3. product-set-id: un identificatore univoco del 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. Dedotto dal sistema se non specificato nella richiesta di creazione. I valori consentiti sono elencati anche nella documentazione di riferimento di productCategory.

  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"

      Product Search dell'API Vision consente inoltre 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 un riquadro di delimitazione non viene specificato:

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

    Vedi l'esempio di seguito per un prodotto per cui non è specificato un poligono di delimitazione.

    Se includi un riquadro di delimitazione, la colonna boundingPoly deve contenere un numero pari di numeri separati da virgole, nel formato p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. Una riga di esempio ha il seguente aspetto: 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 effettivi dei pixel dell'immagine, utilizza numeri interi non negativi. Pertanto, puoi esprimere riquadri di delimitazione in immagini da 1000 x 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,,,

    Product Search dell'API Vision consente anche di utilizzare valori normalizzati per i riquadri di delimitazione. Definisci un riquadro di delimitazione utilizzando valori normalizzati con valori in virgola mobile in [0, 1].

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

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