Memformat suatu CSV impor massal

Anda dapat menggunakan metode import untuk membuat set produk dan produk dengan gambar referensi secara bersamaan menggunakan suatu file CSV. Halaman ini menjelaskan cara memformat file CSV

Membuat gambar referensi Anda

Gambar referensi merupakan gambar yang berisi berbagai tampilan dari produk Anda. Rekomendasi berikut berlaku:

  • Pastikan ukuran file tidak melebihi ukuran maksimum (20 MB).
  • Pertimbangkan sudut pandang yang secara logis menyoroti produk dan berisi informasi visual yang relevan.
  • Buat gambar referensi yang melengkapi sudut pandang yang hilang. Misalnya, jika Anda hanya memiliki gambar sepatu kanan dalam sepasang, berikan versi pencerminan dari file tersebut sebagai sepatu kiri.
  • Upload gambar beresolusi tertinggi yang tersedia.
  • Tampilkan produk dengan latar belakang putih.
  • Konversi PNG dengan latar belakang transparan ke latar belakang solid.

Gambar harus disimpan di bucket Cloud Storage. Jika Anda mengautentikasi panggilan pembuatan image dengan kunci API, bucket harus bersifat publik. Jika Anda mengautentikasi dengan akun layanan, akun layanan tersebut harus memiliki akses baca pada bucket.

Panduan pemformatan CSV

Untuk menggunakan metode import, file CSV dan gambar yang ditunjuknya harus berada di bucket Cloud Storage. File CSV dibatasi hingga maksimum 20.000 baris; setiap baris dibatasi hingga 2.048 karakter. Untuk mengimpor lebih banyak gambar, bagi gambar tersebut menjadi beberapa file CSV.

File CSV harus berisi satu gambar per baris dan berisi kolom berikut:

  1. image-uri: URI Cloud Storage gambar referensi.
  2. image-id: Opsional. Suatu nilai unik jika Anda menyediakannya. Jika tidak, sistem akan menetapkan suatu nilai unik.
  3. product-set-id: ID unik untuk set produk yang akan menerima gambar yang diimpor.

  4. product-id: ID yang ditentukan pengguna untuk produk yang diidentifikasi oleh gambar referensi. product-id dapat dikaitkan dengan beberapa gambar referensi.

  5. product-category: Nilai yang diizinkan adalah homegoods-v2, apparel-v2, toys-v2, packagedgoods-v1, dan general-v1 *; kategori untuk produk yang diidentifikasi oleh gambar referensi. Disimpulkan oleh sistem jika tidak ditentukan dalam permintaan pembuatan. Nilai yang diizinkan juga tercantum dalam productCategory dokumentasi referensi.

  6. product-display-name: Opsional. Jika Anda tidak memberikan nama untuk produk displayName akan ditetapkan ke " ". Anda dapat memperbarui nilai ini nanti.

  7. labels: Opsional. Suatu string (dengan tanda kutip) dari pasangan nilai kunci yang mendeskripsikan produk dalam gambar referensi. Contoh:

    • "category=shoes"

    • "color=black,style=formal"

      Vision API Product Search juga memungkinkan Anda memberikan beberapa nilai untuk satu kunci. Contoh:

    • "category=shoes,category=heels"

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

  8. bounding-poly: Opsional. Menentukan area minat dalam gambar referensi. Jika kotak pembatas tidak ditentukan:

    1. Kotak pembatas untuk gambar disimpulkan oleh Vision API; beberapa region dalam satu gambar dapat diindeks jika beberapa produk terdeteksi oleh API.
    2. Baris harus diakhiri dengan koma.

    Lihat contoh di bawah untuk produk tanpa poli pembatas yang ditentukan.

    Jika Anda menyertakan kotak pembatas, kolom boundingPoly harus berisi jumlah angka genap yang dipisahkan koma, dengan format p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y. Contoh baris terlihat seperti ini: 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9.

    Untuk menentukan kotak pembatas dengan nilai piksel yang sebenarnya dari gambar Anda, gunakan bilangan bulat non-negatif. Dengan demikian, Anda dapat mengekspresikan kotak pembatas dalam gambar 1.000 piksel oleh 1.000 piksel dengan cara berikut:

    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 juga memungkinkan Anda menggunakan nilai yang dinormalkan untuk kotak pembatas. Menentukan kotak pembatas menggunakan nilai yang dinormalisasi dengan nilai float di [0, 1].

    Dengan menggunakan nilai yang dinormalisasi, baris gambar referensi di atas juga dapat dinyatakan sebagai:

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