Method: projects.locations.productSets.import

API asinkron yang mengimpor daftar gambar referensi ke set produk yang ditentukan berdasarkan daftar informasi gambar.

API google.longrunning.Operation dapat digunakan untuk melacak progres dan hasil permintaan. Operation.metadata berisi BatchOperationMetadata. (progres) Operation.response berisi ImportProductSetsResponse. (hasil)

Sumber input metode ini adalah file csv di Google Cloud Storage. Untuk format file csv, lihat ImportProductSetsGcsSource.csv_file_uri.

Permintaan HTTP

POST https://vision.googleapis.com/v1p4beta1/{parent=projects/*/locations/*}/productSets:import

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Project tempat ProductSets harus diimpor.

Format adalahprojects/PROJECT_ID/locations/LOC_ID.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
Kolom
inputConfig

object (ImportProductSetsInputConfig)

Konten input untuk daftar permintaan.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.

ImportProductSetsInputConfig

Konten input untuk metode productSets.import.

Representasi JSON 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
Kolom
gcsSource

object (ImportProductSetsGcsSource)

Lokasi Google Cloud Storage untuk file csv yang menyimpan daftar ImportProductSetRequests di setiap baris.

ImportProductSetsGcsSource

Lokasi Google Cloud Storage untuk file csv yang menyimpan daftar ImportProductSetRequests di setiap baris.

Representasi JSON 
{
  "csvFileUri": string
}
Kolom
csvFileUri

string

URI Google Cloud Storage dari file csv input.

URI harus diawali dengan gs://.

Format file csv input harus berupa satu gambar per baris. Di setiap baris, terdapat 8 kolom.

  1. gambar-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. label
  8. bounding-poly

Kolom image-uri, product-set-id, product-id, dan product-category wajib diisi. Semua kolom lainnya bersifat opsional.

Jika ProductSet atau Product yang ditentukan oleh nilai product-set-id dan product-id tidak ada, sistem akan membuat ProductSet atau Product baru untuk gambar. Dalam hal ini, kolom product-display-name merujuk pada displayName, kolom product-category merujuk pada productCategory, dan kolom labels merujuk pada productLabels.

Kolom image-id bersifat opsional, tetapi harus unik jika diisi. Jika kosong, sistem akan otomatis menetapkan ID unik untuk image.

Kolom product-display-name bersifat opsional. Jika kosong, sistem akan menetapkan kolom displayName untuk produk ke spasi (" "). Anda dapat mengupdate displayName nanti menggunakan API.

Jika Product dengan product-id yang ditentukan sudah ada, sistem akan mengabaikan kolom product-display-name, product-category, dan labels.

Kolom labels (opsional) adalah baris yang berisi daftar key-value pair yang dipisahkan koma, dalam format berikut:

"key_1=value_1,key_2=value_2,...,key_n=value_n"

Kolom bounding-poly (opsional) mengidentifikasi satu wilayah minat dari gambar dengan cara yang sama seperti referenceImages.create. Jika Anda tidak menerangkan kolom bounding-poly, sistem akan mencoba mendeteksi wilayah minat secara otomatis.

Maksimal satu kolom bounding-poly yang diizinkan per baris. Jika gambar berisi beberapa wilayah minat, tambahkan baris ke file CSV yang menyertakan informasi produk yang sama, dan nilai bounding-poly untuk setiap wilayah minat.

Kolom bounding-poly harus berisi angka genap yang dipisahkan koma, dalam format "p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y". Gunakan bilangan bulat non-negatif untuk poligon pembatas absolut, dan nilai float dengan nilai [0, 1] untuk poligon pembatas yang dinormalisasi.

Sistem akan mengubah ukuran gambar jika resolusi gambar terlalu besar untuk diproses (lebih besar dari 20 MP).