Formattazione di un CSV di importazione collettiva

Puoi utilizzare la import per creare un set di prodotti e i prodotti con immagini di riferimento, il tutto nella contemporaneamente 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 varie inquadrature dei tuoi prodotti. La si applicano i seguenti consigli:

  • Assicurati che le dimensioni del file non superino le dimensioni massime (20 MB).
  • Considera punti di vista che mettano logicamente in evidenza il prodotto e contengono informazioni visive pertinenti.
  • Crea immagini di riferimento che integrino eventuali punti di vista mancanti. Per ad esempio, se hai a disposizione solo immagini di una scarpa giusta in un paio, fornisci immagini speculari di questi file nel riquadro di sinistra.
  • Carica l'immagine con la massima risoluzione disponibile.
  • Mostra il prodotto su uno sfondo bianco.
  • Converti i file PNG con uno sfondo trasparente in uno sfondo a tinta unita.

Le immagini devono essere archiviate in un database Cloud Storage di sincronizzare la directory di una VM con un bucket. 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, deve disporre dell'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 trovarsi in un bucket Cloud Storage. I file CSV sono limitati a un massimo di 20.000 linee; ogni riga ha un limite massimo di 2048 caratteri. Per importare più immagini, suddividile in più file CSV.

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

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

  4. product-id: un ID definito dall'utente per il prodotto identificato dal riferimento dell'immagine. 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 dal come immagine di riferimento. Dedotto dal sistema se non specificato in richiesta. 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 (tra virgolette) di una coppia chiave-valore coppie 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 nella come immagine di riferimento. Se un riquadro di delimitazione non è specificato:

    1. I riquadri di delimitazione dell'immagine vengono dedotti dall'API Vision. più regioni in una singola immagine possono essere indicizzate se sono presenti più prodotti rilevato dall'API.
    2. La riga deve terminare con una virgola.

    Consulta 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. Esempio riga è simile a questa: 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. Puoi quindi esprimere riquadri di delimitazione a 1000 pixel immagini da 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 inoltre di utilizzare valori normalizzati per riquadri di delimitazione. Definisci un riquadro di delimitazione utilizzando valori normalizzati con numero in virgola mobile valori in [0, 1].

    Utilizzando i valori normalizzati, le righe dell'immagine di riferimento riportate sopra possono essere espresso 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,,,