Panduan Pengenal Produk

Model Pengenali Produk membantu Anda mengenali dan memahami produk apa saja yang ada dalam gambar yang disediakan atau di rak.

Model ini dapat berfungsi sebagai elemen penyusun AI utama untuk menganalisis dan menafsirkan data gambar produk di toko retail. Misalnya, Anda dapat menggunakan model ini pada gambar galeri yang diambil oleh kamera lokal atau perangkat seluler.

Kasus penggunaan Pengenal Tag dan Pengenal Produk

Model Pengenal Produk dan model Pengenal Tag dapat berfungsi sebagai elemen penyusun AI utama untuk menganalisis dan menafsirkan data gambar di sekitar produk dan tag yang ditemukan di toko retail, seperti gambar pemindaian rak yang diambil oleh kamera yang terpasang atau perangkat / platform seluler.

Model Pengenal produk dan Pengenal tag menggabungkan beberapa kemampuan data dan pemodelan Google AI inti untuk membantu retailer dan/atau partner teknis menyelesaikan masalah utama dalam memahami rak retail, termasuk:

• Mendeteksi, mengenali, dan memahami produk apa saja yang ada dalam gambar atau di rak.
• Mendeteksi, mengenali, dan mengurai tag (misalnya, tag harga, atau tag label teks lainnya) sesuai dengan skema ekstraksi entity pasangan nilai kunci yang ditentukan pengguna.

Secara khusus, beberapa model Google AI yang membedakan disertakan dalam solusi pemeriksaan rak untuk mendukung pemecahan masalah kasus penggunaan ini, seperti

• Model deteksi produk (terlatih sebelumnya oleh Google, tetapi Anda masih dapat menyesuaikannya).
• Model penyematan visual thumbnail produk, yang mengubah gambar thumbnail produk menjadi representasi ruang fitur numerik.
• Model OCR Google, yang mengekstrak semua teks yang terlihat dalam gambar.
• Model ekstraksi entitas Google (yang dapat Anda sesuaikan), yang mengubah teks mentah menjadi entitas bernama pasangan nilai kunci yang ditentukan pengguna.

Selain model AI Google ini, solusi pemeriksaan rak juga memanfaatkan database informasi produk Google yang besar. Data produk dalam database Produk ini mencakup identitas GTIN / UPC produk, merek produk, judul, dan deskripsi lintas bahasa, logo produk, dan gambar dengan berbagai variasi kemasan. Database Produk dengan model penyematan visual thumbnail produk yang disebutkan sebelumnya memungkinkan model Pengenal produk dapat langsung mengenali banyak produk.

Misalnya, dengan gambar rak yang diambil sebagai berikut, solusi pemeriksaan rak bertujuan untuk:

1. Mendeteksi dan melokalkan semua kotak item produk (terlihat, tidak terhalang secara signifikan) dalam gambar, dan mengenali identitas produk dari setiap kotak item produk di tingkat GTIN / UPC.
2. Mendeteksi dan melokalkan semua kotak tag (terlihat) dalam gambar, mengenali semua string teks dalam tag, lalu mencoba mengurai teks ke dalam skema ekstraksi entity pasangan nilai kunci yang ditentukan pengguna, seperti deskripsi item produk, nilai harga.

Dua fitur AI utama untuk mengaktifkan solusi ini adalah model Pengenal Produk dan model Pengenal Tag, yang akan kami berikan detail selengkapnya di bagian berikut. Untuk setiap dari dua API ini yang terutama menyediakan layanan inferensi gambar, ada satu atau beberapa komponen di setiap API yang dapat Anda sesuaikan. Pertama-tama, kita akan menjelaskan jalur inferensi penggunaan API, lalu memberikan beberapa deskripsi singkat tentang cara menyesuaikan komponen yang terlibat, baik melalui beberapa konfigurasi pengguna atau melalui beberapa pelatihan model yang Anda lakukan.

Fungsi Product Recognizer

Model ini mengenali identitas produk individual di tingkat Nomor Barang Perdagangan Global (GTIN) atau tingkat Kode Produk Universal (UPC). Beberapa model Google AI yang membedakan disertakan dalam Product Recognizer untuk memperkuat pemecahan masalah kasus penggunaan ini, seperti:

• Model penyematan visual produk, yang mengubah gambar produk menjadi representasi ruang fitur numerik.
• Teknologi OCR Google, yang mengekstrak semua teks yang terlihat dalam gambar.
• Database produk Google yang digunakan bersama dengan model penyematan visual thumbnail produk memungkinkan model Pengenal Produk mengenali banyak produk dengan segera.

Contoh Objek JSON Output

{
  "imageUri": "gs://test_bucket/test_image.jpg",
  "productRecognitionAnnotations": [
    {
      "detectedText": "Bolthouse Farms Perfectly Protein Tea & Soy Beverage",
      "recognitionResults": [
        {
          "confidence": 0.9420832,
          "productMetadata": {
            "brand": "Bolthouse Farms",
            "gtins": [
              "00071464260804"
              ],
            "locale": "en-US",
            "title": "Bolthouse Farms Perfectly Protein Tea & Soy Beverage, Vanilla Chai Tea - 52 fl oz"
          },
        }
      ]
    }
  ]
}

Konsep API

Ada enam resource API yang ditawarkan untuk membantu membuat katalog produk, pengelolaan set data produk, pembuatan indeks, dan deployment untuk layanan Pengenalan Produk. Hal ini dijelaskan sebagai berikut:

Katalog: Resource root yang mewakili penampung untuk semua produk yang ditawarkan oleh retailer.

Produk: Mewakili produk yang ditawarkan oleh penjual. Product adalah resource turunan dari Catalog.

ProductImage: Gambar yang mewakili tampilan satu produk. ProductImage adalah resource turunan dari Product.

ProductSet: Penampung dengan tingkat perincian yang lebih baik untuk mengatur dan mengelompokkan produk dalam Catalog yang sama. Satu ProductSet dapat berisi satu atau beberapa Product, tetapi tidak "memiliki" Product yang berisi, tetapi mempertahankan "link" ke Product tersebut.

ProductRecognitionIndex: Berisi daftar penyematan gambar yang digunakan untuk algoritma pengenalan produk. ProductRecognitionIndex dapat dibuat dari seluruh Catalog atau dari ProductSet (subset Product dari Catalog).

Endpoint: Penempatan yang membawa semua konfigurasi yang diperlukan untuk melakukan inferensi Pengenalan Produk atau Pengenalan Tag. Untuk Pengenalan Produk, Anda harus menentukan model deteksi produk dan men-deploy ProductRecognitionIndex. Untuk Pengenalan Tag, Anda harus menentukan model deteksi tag dan penguraian entity tag.

Penyiapan lingkungan

Bagian ini menjelaskan cara berinteraksi dengan Store Vision AI RESTful API.

API_ENDPOINT=visionai.googleapis.com
PROJECT_ID=your project ID

Semua metode create mengharuskan Anda menentukan nama/ID resource yang akan dibuat secara eksplisit. Anda dapat menggunakan ID string yang bermakna, misalnya, "product-ABC" atau ID yang dihasilkan secara acak, misalnya, UUID.

Untuk memberikan akses editor kepada peran orang guna menggunakan Store Vision API, jalankan perintah binding iam berikut:

gcloud projects add-iam-policy-binding PROJECT_ID --member='user:USER_ACCOUNT' --role='roles/visionai.editor'

Untuk memberikan akses editor ke akun layanan, gunakan perintah di bawah:

gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:SERVICE_ACCOUNT' --role='roles/visionai.editor'

Pelajari lebih lanjut binding IAM.

Perjalanan pengguna Product Recognizer

1. Buat Katalog.
2. Impor Produk dan (opsional) ProductImages ke Catalog.
3. Lihat dan ubah Product dan ProductImages, dan secara opsional buat ProductSet untuk mengatur daftar produk dalam tingkat perincian yang lebih baik.
4. Buat Index, baik dari seluruh Catalog atau dari ProductSet.
5. Buat Endpoint dengan konfigurasi pengenalan produk yang diinginkan dan deploy Index ke dalamnya.
6. Lakukan BatchAnalyze dengan fitur ProductRecognition. Di backend, sistem akan mengidentifikasi produk dari setiap gambar input dan mengambil produk serupa top K dari indeks yang ditentukan menggunakan sinyal teks visual dan OCR.

Pengelolaan resource API (Katalog dan Set indeks)

Katalog

Membuat Katalog

• CATALOG_ID=ID katalog Anda.

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{}' https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs?retail_catalog_id=CATALOG_ID

Contoh output

{
  "name": "projects/cloud-store-vision-test/locations/us-central1/operations/operation-1655157982362-5e15b7f95fa6f-d30364c6-dc3a3714",
  "done": false
}

Operasi Pull hingga selesai

• OPERATION_ID=Operasi output Anda, misalnya, operation-1655157982362-5e15b7f95fa6f-d30364c6-dc3a3714

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/operations/OPERATION_ID

Contoh output

{
  "name": "projects/cloud-store-vision-test/locations/us-central1/operations/operation-1655157982362-5e15b7f95fa6f-d30364c6-dc3a3714",
  "done": true
}

ImportProduct

Ada dua format impor yang didukung:

• TXT: setiap baris adalah gtin Produk yang akan diimpor
• JSONL: setiap baris adalah format JSON RetailProductIoFormat, misalnya,

{"retailProduct":{"name":"00040094314034","gtins":["00040094314034"]},"retailProductImages":[{"name":"1","gcsUri":"gs://shelfchecking-integration-test-data/products-data/00040094314034/1.jpg"}]}
{"retailProduct": {"name":"00123", "thirdPartyIds": {"id": "test-id", "owner": "test-owner"}}}

Lihat referensi API untuk mengetahui detail selengkapnya tentang RetailProductIoFormat. Saat ini kami mendukung impor maksimum 10.000 produk per operasi ImportProduct.

Perhatikan juga bahwa "name" dalam "retailProductImages" hanya perlu unik dalam cakupan resource "retailProduct" induk, yang berarti dapat ada 2 "retailProductImages" dengan "name" yang sama selama keduanya milik resource "retailProduct" yang berbeda.

• IMPORT_FILE_URI=URI Cloud Storage file impor Anda, misalnya, gs://mybucket/my_import_file.jsonl
• IMPORT_FORMAT=Format file impor Anda, baik FORMAT_JSONL maupun FORMAT_TXT

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID:importRetailProducts \
  -d '{
    "gcs_source": {
      "uris": "IMPORT_FILE_URI"
    },
    "format": "IMPORT_FORMAT"
  }'

Mencantumkan Katalog

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs

GetCatalog

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID

DeleteCatalog

curl -sS -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID

Produk

CreateProduct dengan GTIN

Kami mendukung format GTIN-8, GTIN-13, GTIN-14, dan UPC(juga dikenal sebagai GTIN-12). Pelajari format GTIN lebih lanjut di sini.

• PRODUCT_ID=ID produk Anda
• GTIN=gtin produk Anda, misalnya, 50735854797459, 00040094314034

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts?retail_product_id=PRODUCT_ID \
  -d '{"gtins": "GTIN"}'

CreateProduct dengan ID Pihak Ketiga

• PRODUCT_ID=ID produk Anda
• THIRD_PARTY_ID=ID pihak ketiga
• OWNER=Entitas yang memiliki ID pihak ketiga

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts?retail_product_id=PRODUCT_ID \
-d '
  {
    "third_party_ids": {
      "id": "THIRD_PARTY_ID",
      "owner": "OWNER",
    }
  }'

ListProducts

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts

GetProducts

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts/PRODUCT_ID

DeleteProduct

curl -sS -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts/PRODUCT_ID

ProductImage

CreateProductImage

• PRODUCT_IMAGE_ID=ID gambar produk Anda
• IMAGE_GCS_URI=URI Cloud Storage gambar Anda, misalnya, gs://mybucket/my_img.jpg

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts/PRODUCT_ID/retailProductImages?retail_product_image_id=PRODUCT_IMAGE_ID \
  -d '{
    "source_type": "SOURCE_TYPE_HAND_HELD_CAMERA",
    "gcs_uri": "IMAGE_GCS_URI"
  }'

ListProductImages

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts/PRODUCT_ID/retailProductImages

GetProductImages

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts/PRODUCT_ID/retailProductImages/PRODUCT_IMAGE_ID

DeleteProductImage

curl -sS -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProducts/PRODUCT_ID/retailProductImages/PRODUCT_IMAGE_ID

ProductSet

CreateProductSet

• PRODUCT_SET_ID=ID kumpulan produk Anda

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -d '{}' https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductSets?retail_product_set_id=PRODUCT_SET_ID

ListProductSet

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductSets

GetProductSet

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductSets/PRODUCT_SET_ID

AddProductsToProductSet

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductSets/PRODUCT_SET_ID:add \
  -d '{"product_ids": "PRODUCT_ID"}'

RemoveProductsFromProductSet

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductSets/PRODUCT_SET_ID:remove \
  -d '{"product_ids": "PRODUCT_ID"}'

DeleteProductSet

curl -sS -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductSets/PRODUCT_SET_ID

ProductRecognitionIndex

Membuat ProductRecognitionIndex

Ada dua cara untuk membuat ProductRecognitionIndex, baik dari Katalog yang akan menggunakan semua yang ada dalam Katalog ini, atau dari ProductSet yang hanya akan menggunakan produk dan gambar produk terkait.

• INDEX_ID=ID indeks Anda
• COVERAGE_CSV_OUTPUT_DIRECTORY=<Cloud Storage location of the directory where index coverage file will be written to

# Create from Catalog
curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductRecognitionIndexes?retail_product_recognition_index_id=INDEX_ID

# Create from Catalog and output index coverage CSV file to a Cloud Storage directory.
# This API method is especially useful when you want to understand the
# actual number of images used to construct the index per imported GTIN, and
# the image can be sourced from the Google Product database, your own importing,
# and other means (such as with the Google Data Labeling service.
curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" "https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductRecognitionIndexes?retail_product_recognition_index_id=INDEX_ID&coverage_output.output_uri_prefix=COVERAGE_CSV_OUTPUT_DIRECTORY"

# Create from ProductSet, by adding the following to the previous Curl command
-d '{"retail_product_set": "projects/PROJECT_ID/locations/us-central1/retailCatalogs/'CATALOG_ID'/retailProductSets/PRODUCT_SET_ID"}'

Mendapatkan ProductRecognitionIndex

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductRecognitionIndexes/INDEX_ID

Mencantumkan ProductRecognitionIndex

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductRecognitionIndexes

Menghapus ProductRecognitionIndex

curl -sS -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailCatalogs/CATALOG_ID/retailProductRecognitionIndexes/INDEX_ID

Endpoint

Membuat Endpoint

• ENDPOINT_ID=ID endpoint Anda

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints?retail_endpoint_id=ENDPOINT_ID -d '{
  "productRecognitionConfig": {
    "recognitionConfidenceThreshold": 0.4
  }
}'

DeployProductRecognitionIndex

Endpoint hanya dapat di-deploy dengan satu ProductRecognitionIndex, tetapi satu ProductRecognitionIndex dapat di-deploy ke beberapa Endpoint.

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints/ENDPOINT_ID:deployRetailProductRecognitionIndex \
  -d '{
    "retail_product_recognition_index": "projects/PROJECT_ID/locations/us-central1/retailCatalogs/'CATALOG_ID'/retailProductRecognitionIndexes/INDEX_ID"
  }'

GetEndpoint

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints/ENDPOINT_ID

ListEndpoints

curl -sS -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints

UndeployProductRecognitionIndex

Penghentian deployment hanya akan menghapus ProductRecognitionIndex yang di-deploy dari Endpoint panggilan saat ini, dan tidak akan memengaruhi Endpoint lain jika ProductRecognitionIndex ini juga di-deploy ke Endpoint lain.

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints/ENDPOINT_ID:undeployRetailProductRecognitionIndex

DeleteEndpoint

curl -sS -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints/ENDPOINT_ID

Batch Analyze Inference (Pengenalan Produk)

Contoh file input di gs://my-bucket/input-file.csv:

gs://my-bucket/my-image1.jpg
gs://my-bucket/my-image2.jpg
gs://my-bucket/my-image3.jpg

• INPUT_FILE_URI=URI Cloud Storage file input Anda> setiap baris dalam file input hanyalah URI Cloud Storage gambar yang akan diproses, misalnya, gs://my-bucket/my-image.jpg
• OUTPUT_URI_PREFIX=Awal uri Cloud Storage untuk file hasil output, misalnya, gs://my-bucket/my-output-dir

curl -sS -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints/ENDPOINT_ID:batchAnalyze -d '{
  "gcsSource": {
    "uris": ["INPUT_FILE_URI"]
  },
  "features": [
    {
      "type": "TYPE_PRODUCT_RECOGNITION",
     }
  ],
  "outputGcsDestination": {
    "outputUriPrefix": "OUTPUT_URI_PREFIX"
  }
}'

Catatan: Anda dapat mengganti productRecognitionConfig di Endpoint dengan menentukan satu di permintaan BatchAnalyze.

"features": [
    {
      "type": "TYPE_PRODUCT_RECOGNITION",
      "productRecognitionConfig": {
        "recognitionConfidenceThreshold": 0.4
      }
    }
  ],

Ada juga kolom lain yang dapat Anda tetapkan dan konfigurasikan di productRecognitionConfig, yang merupakan objek RetailProductRecognitionConfig. Lihat deskripsi resource dalam referensi API untuk mengetahui detail selengkapnya.

Referensi API

Resource: projects.locations.retailCatalogs

Representasi JSON

{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "resourceState": enum(RetailResourceState),
  "labels": {
    string: string,
    ...
  }
}

Kolom

nama	String	Hanya output. Nama resource RetailCatalog
displayName	String	Opsional. Nama tampilan RetailCatalog.
createTime	string (format Timestamp)	Hanya output. Stempel waktu saat RetailCatalog ini dibuat.
updateTime	string (format Timestamp)	Hanya output. Stempel waktu update.
resourceState	enum	Hanya output. Status RetailCatalog.
Label	peta (kunci: string, nilai: string)	Label dengan metadata yang ditentukan pengguna untuk mengatur RetailCatalog Anda. Kunci dan nilai label tidak boleh lebih dari 64 karakter (kode titik Unicode), hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Lihat https://goo.gl/xmQnxf untuk mengetahui informasi selengkapnya tentang dan contoh label. Objek yang berisi daftar pasangan nilai "kunci". Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Metode: projects.locations.retailCatalogs.create

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/us-central1}/retailCatalogs

Parameter jalur

parent	string	Wajib. ID induk.

Isi permintaan

Isi permintaan memuat instance RetailCatalog.

Isi respons

Jika berhasil, isi respons akan memuat instance RetailCatalog yang baru dibuat.

Metode: projects.locations.retailCatalogs.get

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/us-central1/retailCatalogs/*}

Parameter jalur

nama	string	Wajib. ID RetailCatalog.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailCatalog.

Metode: projects.locations.retailCatalogs.list

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/us-central1}/retailCatalogs

Parameter jalur

parent	string	Wajib. ID induk.

Parameter kueri

filter	string	Opsional. Ekspresi untuk memfilter hasil permintaan.
pageToken	string	Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan oleh server.
pageSize	bilangan bulat	Opsional. Ukuran halaman yang diminta. Server mungkin menampilkan item yang lebih sedikit daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
orderBy	string	Opsional. Daftar kolom yang dipisahkan koma untuk diurutkan berdasarkan urutan menaik. Gunakan "desc" setelah nama kolom untuk menurun.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons berisi data dengan struktur berikut: representasi JSON

{
  "retailCatalogs": [
    {
      object (RetailCatalog)
    }
  ],
  "nextPageToken": string
}

Metode: projects.locations.retailCatalogs.delete

Permintaan HTTP

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/us-central1/retailCatalogs/*}

Parameter jalur

nama	string	Wajib. ID RetailCatalog.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Metode: projects.locations.retailCatalogs.importRetailProducts

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/us-central1/retailCatalogs/*}:importRetailProducts

Parameter jalur

nama	string	Wajib. Nama resource RetailCatalog.

Isi permintaan

Representasi JSON

{
  "gcsSource": { object(GcsSource) },
  "format": enum(Format)
}

Kolom

gcsSource	objek	Wajib. Lokasi Cloud Storage untuk konten input. Beberapa lokasi input dapat diberikan. Konten semua lokasi input akan diimpor dalam satu batch. Ekstensi file yang didukung: 1. File JSONL. Setiap baris adalah format JSON RetailProductIoFormat. 2. File TXT. Setiap baris adalah gtin Produk yang akan diimpor.
format	enum	Wajib. Format file impor.

Memformat nilai ENUM

FORMAT_UNSPECIFIED	Tidak boleh digunakan.
FORMAT_TXT	Format TXT.
FORMAT_JSONL	Format JSONL.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Resource: projects.locations.retailProducts

Representasi JSON

{
  "name": string,
  "gtins": [string],
  "normalizedGtins": [string],
  "thirdPartyIds": [ { object(ThirdPartyId) }],
  "locale": string,
  "brand": string,
  "title": string,
  "productUri": string,
  "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

Kolom

nama	String	Hanya output. Nama resource RetailProductImage
displayName	String	Opsional. Nama tampilan RetailProductImage.
sourceType	enum	Opsional. Jenis sumber
gcsUri	string	Opsional. Lokasi Cloud Storage RetailProductImage. Kolom ini harus ditetapkan kecuali jika gambar disediakan oleh Google, misalnya, jika jenis sumbernya adalah SOURCE_TYPE_GOOGLE.
resourceState	enum	Hanya output. Status RetailProductImage.
Label	peta (kunci: string, nilai: string)	Label dengan metadata yang ditentukan pengguna untuk mengatur RetailProductImage Anda. Kunci dan nilai label tidak boleh lebih dari 64 karakter (kode titik Unicode), hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Lihat https://goo.gl/xmQnxf untuk mengetahui informasi selengkapnya tentang label dan contoh label. Objek yang berisi daftar pasangan nilai "kunci". Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (format Timestamp)	Hanya output. Stempel waktu pembuatan.
updateTime	string (format Timestamp)	Hanya output. Stempel waktu update.

Presentasi JSON RetailThirdPartyId

{
  "id": string,
  "owner": string
}

Kolom

id	string	ID pihak ketiga yang digunakan oleh retailer atau produsen (misalnya, SKU atau MPN).
owner	string	Entitas yang 'memiliki' ID pihak ketiga, misalnya, produsen atau retailer yang menjual produk ini.

Metode: projects.locations.retailCatalogs.retailProducts.create

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProducts

Parameter jalur

parent	string	Wajib. ID induk.

Isi permintaan

Isi permintaan memuat instance RetailProduct.

Isi respons

Jika berhasil, isi respons akan memuat instance RetailProduct yang baru dibuat.

Metode: projects.locations.retailCatalogs.retailProducts.get

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*

Parameter jalur

nama	string	Wajib. ID RetailProduct.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailProduct.

Metode: projects.locations.retailCatalogs.retailProducts.list

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProducts

Parameter jalur

parent	string	Wajib. ID induk.

Parameter kueri

filter	string	Opsional. Ekspresi untuk memfilter hasil permintaan.
pageToken	string	Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan oleh server.
pageSize	bilangan bulat	Opsional. Ukuran halaman yang diminta. Server mungkin menampilkan item yang lebih sedikit daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
orderBy	string	Opsional. Daftar kolom yang dipisahkan koma untuk diurutkan berdasarkan urutan menaik. Gunakan "desc" setelah nama kolom untuk menurun.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons berisi data dengan struktur berikut: representasi JSON

{
  "retailProducts": [
    {
      object (RetailProducts)
    }
  ],
  "nextPageToken": string
}

Metode: projects.locations.retailCatalogs.retailProducts.delete

Permintaan HTTP

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*

Parameter jalur

nama	string	Wajib. ID RetailProduct.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan kosong.

Resource: projects.locations.retailProductImages

Representasi JSON

{
  "name": string,
  "displayName": string,
  "sourceType": enum(SourceType),
  "gcsUri": string,
  "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

Kolom

nama	String	Hanya output. Nama resource RetailProductImage
displayName	String	Opsional. Nama tampilan RetailProductImage.
sourceType	enum	Opsional. Jenis sumber
gcsUri	string	Opsional. Lokasi Cloud Storage RetailProductImage. Kolom ini harus ditetapkan kecuali jika gambar disediakan oleh Google, misalnya, jika jenis sumbernya adalah SOURCE_TYPE_GOOGLE.
resourceState	enum	Hanya output. Status RetailProductImage.
Label	map (key: string, value: string)	Label dengan metadata yang ditentukan pengguna untuk mengatur RetailProductImage Anda. Kunci dan nilai label tidak boleh lebih dari 64 karakter (kode titik Unicode), hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Lihat https://goo.gl/xmQnxf untuk mengetahui informasi selengkapnya tentang label dan contoh label. Objek yang berisi daftar pasangan nilai "kunci". Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (format Timestamp)	Hanya output. Stempel waktu pembuatan.
updateTime	string (format Timestamp)	Hanya output. Stempel waktu update.

Nilai ENUM SourceType

SOURCE_TYPE_UNSPECIFIED	Sumber data tidak diketahui. Tidak boleh digunakan.
SOURCE_TYPE_FIXED_CAMERA	Gambar diambil dari kamera tetap.
SOURCE_TYPE_HAND_HELD_CAMERA	Gambar diambil dari kamera genggam.
SOURCE_TYPE_CRAWLED	Gambar di-crawl dari web.
SOURCE_TYPE_SYSTEM_GENERATED	Gambar dipangkas dari gambar asli dengan pelabelan manusia.

Metode: projects.locations.retailCatalogs.retailProducts.retailProductImages.create

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*/retailProducts/*}/retailProductImages

Parameter jalur

parent	string	Wajib. ID induk.

Isi permintaan

Isi permintaan memuat instance RetailProductImage.

Isi respons

Jika berhasil, isi respons akan memuat instance RetailProductImage yang baru dibuat.

Metode: projects.locations.retailCatalogs.retailProducts.retailProductImages.get

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*/retailProductImages/*

Parameter jalur

nama	string	Wajib. ID RetailProductImage.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailProductImage.

Metode: projects.locations.retailCatalogs.retailProducts.retailProductImages.list

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*/retailProducts/*}/retailProductImages

Parameter jalur

parent	string	Wajib. ID induk.

Parameter kueri

filter	string	Opsional. Ekspresi untuk memfilter hasil permintaan.
pageToken	string	Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan oleh server.
pageSize	bilangan bulat	Opsional. Ukuran halaman yang diminta. Server mungkin menampilkan item yang lebih sedikit daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
orderBy	string	Opsional. Daftar kolom yang dipisahkan koma untuk diurutkan berdasarkan urutan menaik. Gunakan "desc" setelah nama kolom untuk menurun.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON

{
  "retailProductImages": [
    {
      object (RetailProductImages)
    }
  ],
  "nextPageToken": string
}

Metode: projects.locations.retailCatalogs.retailProducts.retailProductImages.delete

Permintaan HTTP

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*/retailProductImages/*

Parameter jalur

nama	string	Wajib. ID RetailProductImage.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan kosong.

Resource: projects.locations.retailCatalogs.retailProductSets

Representasi JSON

{
  "name": string,
  "displayName": string,
  "retailProductIds": [string],
  "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

Kolom

nama	String	Hanya output. Nama resource RetailProductSet
displayName	String	Opsional. Nama tampilan RetailProductSet.
retailProductIds []	String	Hanya output. ID resource produk yang termasuk dalam RetailProductSet ini. Produk dalam RetailProductSet harus berada dalam katalog yang sama.
resourceState	enum	Hanya output. Status RetailProductSet.
Label	peta (kunci: string, nilai: string)	Label dengan metadata yang ditentukan pengguna untuk mengatur RetailProductSet Anda. Kunci dan nilai label tidak boleh lebih dari 64 karakter (kode titik Unicode), hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Lihat https://goo.gl/xmQnxf untuk mengetahui informasi selengkapnya tentang label dan contoh label. Objek yang berisi daftar pasangan nilai "kunci". Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (format Timestamp)	Hanya output. Stempel waktu pembuatan.
updateTime	string (format Timestamp)	Hanya output. Stempel waktu update.

Metode: projects.locations.retailCatalogs.retailProductSets.create

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductSets

Parameter jalur

parent	string	Wajib. ID induk.

Isi permintaan

Isi permintaan berisi instance RetailProductSet.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailProductSet yang baru dibuat.

Metode: projects.locations.retailCatalogs.retailProductSets.get

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*

Parameter jalur

nama	string	Wajib. ID RetailProductSet.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailProductSet.

Metode: projects.locations.retailCatalogs.retailProductSets.list

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductSets

Parameter jalur

parent	string	Wajib. ID induk.

Parameter kueri

filter	string	Opsional. Ekspresi untuk memfilter hasil permintaan.
pageToken	string	Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan oleh server.
pageSize	bilangan bulat	Opsional. Ukuran halaman yang diminta. Server mungkin menampilkan item yang lebih sedikit daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
orderBy	string	Opsional. Daftar kolom yang dipisahkan koma untuk diurutkan berdasarkan urutan menaik. Gunakan "desc" setelah nama kolom untuk menurun.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON

{
  "retailProductSets": [
    {
      object (RetailProductSets)
    }
  ],
  "nextPageToken": string
}

Metode: projects.locations.retailCatalogs.retailProductSets.delete

Permintaan HTTP

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*

Parameter jalur

nama	string	Wajib. ID RetailProductSet.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan kosong.

Metode: projects.locations.retailCatalogs.retailProductSets.add

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*}:remove

Parameter jalur

nama	string	Wajib. Nama resource RetailProductSet.

Isi permintaan

Representasi JSON

{
  "productIds": [string],
  "productFilter": string
}

Kolom

productIds[ ]	string	ID resource RetailProducts yang akan ditambahkan. Semuanya harus termasuk dalam RetailCatalog yang sama dengan RetailProductSet tujuan yang ditentukan. Maksimal 200 ID RetailProducts dapat ditentukan dalam satu permintaan. Tidak dapat digunakan bersama dengan productFilter.
productFilter	string	Filter standar yang akan diterapkan ke semua RetailProducts di RetailCatalog induk, pilih item yang memenuhi kondisi filter, lalu tambahkan ke RetailProductSet. Tidak dapat digunakan bersama dengan product_ids. Filter yang didukung: https://google.aip.dev/160

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Metode: projects.locations.retailCatalogs.retailProductSets.remove

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*}:add

Parameter jalur

nama	string	Wajib. Nama resource RetailProductSet.

Isi permintaan

Representasi JSON

{
  "productIds": [string],
  "productFilter": string
}

Kolom

productIds[ ]	string	ID resource RetailProducts yang akan dihapus. Jika RetailProducts yang ditentukan bukan milik RetailProductSet ini, RetailProducts tersebut akan diabaikan. Maksimal 200 ID RetailProducts dapat ditentukan dalam satu permintaan. Tidak dapat digunakan bersama dengan products_filter.
productFilter	string	Filter standar yang akan diterapkan ke semua RetailProducts dalam RetailProductSet yang ditentukan, pilih item yang memenuhi kondisi filter, lalu hapus dari RetailProductSet. Tidak dapat digunakan bersama dengan product_ids. Filter yang didukung:https://google.aip.dev/160

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Resource: projects.locations.retailCatalogs.retailProductRecognitionIndexes

Representasi JSON

{
  "name": string,
  "displayName": string,
  "description": string,
  "retailProductSet": [string],
   "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

Kolom

nama	String	Hanya output. Nama resource RetailProductRecognitionIndex.
displayName	String	Opsional. Nama tampilan RetailProductRecognitionIndex.
deskripsi	String	Opsional. Deskripsi RetailProductRecognitionIndex.
retailProductSet[]	string	Opsional. Nama resource RetailProductSet yang akan digunakan untuk membuat resource ini. Jika ditetapkan, RetailProductRecognitionIndex hanya akan berisi produk dalam RetailProductSet yang diberikan. Jika tidak ditetapkan, semua produk di katalog induk akan digunakan.
resourceState	enum	Hanya output. Status RetailProductRecognitionIndex.
Label	map (key: string, value: string)	Label dengan metadata yang ditentukan pengguna untuk mengatur RetailProductRecognitionIndex Anda. Kunci dan nilai label tidak boleh lebih dari 64 karakter (kode titik Unicode), hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Lihat https://goo.gl/xmQnxf untuk mengetahui informasi selengkapnya tentang label dan contoh label. Objek yang berisi daftar pasangan nilai "kunci". Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (format Timestamp)	Hanya output. Stempel waktu pembuatan.
updateTime	string (format Timestamp)	Hanya output. Stempel waktu update.

Metode: projects.locations.retailCatalogs.retailProductRecognitionIndexes.create

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductRecognitionIndexes

Parameter jalur

parent	string	Wajib. ID induk.

Isi permintaan

Isi permintaan memuat instance RetailProductRecognitionIndex.

Isi respons

Jika berhasil, isi respons akan memuat instance RetailProductRecognitionIndex yang baru dibuat.

Metode: projects.locations.retailCatalogs.retailProductRecognitionIndexes.get

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductRecognitionIndexes/*

Parameter jalur

nama	string	Wajib. ID RetailProductRecognitionIndex.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailProductRecognitionIndex.

Metode: projects.locations.retailCatalogs.retailProductRecognitionIndexes.list

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductRecognitionIndexes

Parameter jalur

parent	string	Wajib. ID induk.

Parameter kueri

filter	string	Opsional. Ekspresi untuk memfilter hasil permintaan.
pageToken	string	Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan oleh server.
pageSize	bilangan bulat	Opsional. Ukuran halaman yang diminta. Server mungkin menampilkan item yang lebih sedikit daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
orderBy	string	Opsional. Daftar kolom yang dipisahkan koma untuk diurutkan berdasarkan urutan menaik. Gunakan "desc" setelah nama kolom untuk menurun.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON

{
  "retailProductRecognitionIndexes": [
    {
      object (RetailProductRecognitionIndex)
    }
  ],
  "nextPageToken": string
}

Metode: projects.locations.retailCatalogs.retailProductRecognitionIndexes.delete

Permintaan HTTP

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductRecognitionIndexes/*

Parameter jalur

nama	string	Wajib. ID ProductRecognitionIndex.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Resource: projects.locations.retailEndpoints

Representasi JSON

{
  "name": string,
  "displayName": string,
  "description": string,
  "deployedProductRecognitionIndex": string,
  "resourceState": enum(RetailResourceState),
  "productRecognitionConfig": { object(RetailProductRecognitionConfig) },
  "tagRecognitionConfig": { object(RetailTagRecognitionConfig) },
  "labels": {
    string: string,
    ...
   }
  "createTime": string,
  "updateTime": string
}

Kolom

nama	String	Hanya output. Nama resource RetailEndpoint.
displayName	String	Opsional. Nama tampilan RetailEndpoint.
deskripsi	String	Opsional. Deskripsi RetailEndpoint.
deployedProductRecognitionIndex	String	Hanya output. Nama resource ProductRecognitionIndex yang di-deploy ke RetailEndpoint ini.
productRecognitionConfig	Objek	Opsional. Konfigurasi untuk pengenalan produk.
tagRecognitionConfig	Objek	Opsional. Konfigurasi untuk pengenalan tag.
resourceState	enum	Hanya output. Status RetailProductRecognitionIndex.
Label	map (key: string, value: string)	Label dengan metadata yang ditentukan pengguna untuk mengatur RetailProductRecognitionIndex Anda. Kunci dan nilai label tidak boleh lebih dari 64 karakter (kode titik Unicode), hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Karakter internasional diperbolehkan. Lihat https://goo.gl/xmQnxf untuk mengetahui informasi selengkapnya tentang label dan contoh label. Objek yang berisi daftar pasangan nilai "kunci". Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (format Timestamp)	Hanya output. Stempel waktu pembuatan.
updateTime	string (format Timestamp)	Hanya output. Stempel waktu update.

RetailProductRecognitionConfig

Representasi JSON

{
  "productDetectionModel": string,
  "detectionConfidenceThreshold": float,
  "recognitionConfidenceThreshold": float,
  "additionalConfig": { object }
}

Kolom

|

productDetectionModel	string	Wajib. Model yang akan digunakan untuk mendeteksi produk dalam gambar input. Nilai yang didukung: "builtin/stable" (default) atau nama resource model Vertex AI.
detectionConfidenceThreshold	float	Opsional. Nilai minimum keyakinan untuk memfilter hasil deteksi. Jika tidak ditetapkan, nilai default sistem akan digunakan.
recognitionConfidenceThreshold	float	Opsional. Batas keyakinan untuk memfilter hasil pengenalan. Jika tidak ditetapkan, nilai default sistem akan digunakan.
additionalConfig	objek (format Struct)	Opsional. Konfigurasi tambahan untuk pengenalan produk.

RetailTagRecognitionConfig

Representasi JSON

{
  "tagDetectionModel": string,
  "tagParsingModel": string,
  "detectionConfidenceThreshold": float,
  "parsingConfidenceThreshold": float,
  "additionalConfig": { object }
}

Kolom

tagDetectionModel	string	Wajib. Model yang akan digunakan untuk mendeteksi tag dalam gambar input. Nilai yang didukung: Resource model Vertex AI.
tagParsingModel	string	Wajib. Model untuk mengurai teks pada tag yang terdeteksi. Nilai yang didukung: Resource model Vertex AI.
detectionConfidenceThreshold	float	Opsional. Nilai minimum keyakinan untuk memfilter hasil deteksi. Jika tidak ditetapkan, nilai default sistem akan digunakan.
parsingConfidenceThreshold	float	Opsional. Ambang batas keyakinan untuk memfilter hasil penguraian teks. Jika tidak ditetapkan, nilai default sistem akan digunakan.
additionalConfig	objek (format Struct)	Opsional. Konfigurasi tambahan untuk pengenalan tag.

Metode: projects.locations.retailEndpoints.create

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/retailEndpoints

Parameter jalur

parent	string	Wajib. ID induk.

Isi permintaan

Isi permintaan memuat instance RetailEndpoint.

Isi respons

Jika berhasil, isi respons akan memuat instance RetailEndpoint yang baru dibuat.

Metode: projects.locations.retailEndpoints.get

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailEndpoints/*}

Parameter jalur

nama	string	Wajib. ID RetailEndpoint.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance RetailEndpoint.

Metode: projects.locations.retailEndpoints.list

Permintaan HTTP

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/retailEndpoints

Parameter jalur

parent	string	Wajib. ID induk.

Parameter kueri

filter	string	Opsional. Ekspresi untuk memfilter hasil permintaan.
pageToken	string	Opsional. Token yang mengidentifikasi halaman hasil yang harus ditampilkan oleh server.
pageSize	bilangan bulat	Opsional. Ukuran halaman yang diminta. Server mungkin menampilkan item yang lebih sedikit daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
orderBy	string	Opsional. Daftar kolom yang dipisahkan koma untuk diurutkan berdasarkan urutan menaik. Gunakan "desc" setelah nama kolom untuk menurun.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON

{
  "retailEndpoints": [
    {
      object (RetailEndpoint)
    }
  ],
  "nextPageToken": string
}

Metode: projects.locations.retailEndpoints.delete

Permintaan HTTP

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailEndpoints/*

Parameter jalur

nama	string	Wajib. ID RetailEndpoint.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan kosong.

Metode: projects.locations.retailEndpoints.deployRetailProductRecognitionIndex

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{retailEndpoint=projects/*/locations/*/retailEndpoints/*}:deployRetailProductRecognitionIndex

Parameter jalur

retailEndpoint	string	Wajib. Nama resource dari resource RetailEndpoint ke tempat RetailProductRecognitionIndex di-deploy.

Isi permintaan

Representasi JSON

{
  "retailProductRecognitionIndex": string,
}

Kolom

retailProductRecognitionIndex	string	Wajib. Nama resource RetailProductRecognitionIndex yang akan di-deploy.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Metode: projects.locations.retailEndpoints.undeployRetailProductRecognitionIndex

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{retailEndpoint=projects/*/locations/*/retailEndpoints/*}:undeployRetailProductRecognitionIndex

Parameter jalur

retailEndpoint	string	Wajib. Nama resource resource RetailEndpoint tempat penghapusan deployment akan dilakukan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Metode: projects.locations.retailEndpoints.batchAnalyze

Permintaan HTTP

POST https://visionai.googleapis.com/v1alpha1/{retailEndpoint=projects/*/locations/*/retailEndpoints/*}:batchAnalyze

Parameter jalur

retailEndpoint	string	Wajib. Nama resource RetailEndpoint untuk menayangkan permintaan inferensi.

Isi permintaan

Representasi JSON

{
  "gcsSource": string,
  "features": { object(Feature) },
  // Union field output can be only one of the following:
  "outputGcsDestination": string,
  "corpus": string,
  // End of list of possible types for union field output.
  "bigqueryTable": string
}

Kolom

gcsSource	string	Wajib. Lokasi Cloud Storage untuk konten input. Beberapa lokasi input dapat diberikan. Konten semua lokasi input akan diproses dalam satu batch. Konten yang didukung: File TXT, setiap barisnya adalah jalur lengkap ke gambar. Maksimum 50 ribu gambar dapat didukung dalam satu permintaan.
outputGcsDestination	string	Opsional. Lokasi Cloud Storage direktori tempat output akan ditulis.
corpus	string	Opsional. Nama resource korpus gudang gambar. Belum didukung.
bigqueryTable	string	Opsional. Nama resource tabel bigquery untuk ekspor anotasi. Dalam format "projects/*/datasets/*/tables/*". Jika ditetapkan, anotasi yang dihasilkan dari inferensi ML juga akan diekspor ke tabel bigquery yang diberikan. Belum didukung.
features[]	Objek	Wajib. Jenis inferensi ML yang akan dilakukan.

Fitur

Representasi JSON

{
  "type": enum(Type),
  "productRecognitionConfig": object(RetailProductRecognitionConfig),
  "tagRecognitionConfig": object(RetailTagRecognitionConfig)
}

Kolom

jenis	enum	Wajib. Jenis Fitur.
productRecognitionConfig	objek	Opsional. Penggantian per permintaan untuk fitur pengenalan produk. Hal ini hanya efektif jika jenis ditetapkan ke TYPE_PRODUCT_RECOGNITION.
tagRecognitionConfig	objek	Opsional. Penggantian per permintaan untuk fitur pengenalan tag. Hal ini hanya efektif jika jenis ditetapkan ke TYPE_TAG_RECOGNITION.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Jenis

GcsSource

Representasi JSON

{
  "uris": [string]
}

Kolom

uris[]	string	Wajib. Referensi ke jalur Cloud Storage.

Jenis

Nilai ENUM

TYPE_UNSPECIFIED	Nilai default. Tidak boleh digunakan.
TYPE_PRODUCT_RECOGNITION	Pengenalan Produk. Harus digunakan di RetailEndpoint dengan RetailProductRecognitionIndex yang di-deploy.
TYPE_TAG_RECOGNITION	Deteksi dan Mengurai Tag. Harus digunakan di RetailEndpoint dengan RetailTagRecognitionConfig.

RetailProductIoFormat

Representasi JSON

{
  "retailProduct": { object(RetailProduct) },
  "retailProductImages": [ { object(RetailProductImage) }]
}

Kolom

retailProduct	objek	Wajib. RetailProduct yang akan diimpor
retailProductImages[ ]	objek	Opsional. RetailProductImage dari RetailProduct yang ditentukan untuk diimpor.

RetailResourceState

Nilai ENUM

RETAIL_RESOURCE_STATE_UNSPECIFIED	Nilai default. Tidak boleh digunakan.
RETAIL_RESOURCE_STATE_CREATING	Pembuatan Status.
RETAIL_RESOURCE_STATE_CREATED	Status Dibuat.
RETAIL_RESOURCE_STATE_UPDATING	Memperbarui Status.
RETAIL_RESOURCE_STATE_DELETED	Status Dihapus.
RETAIL_RESOURCE_STATE_ERROR	Error Status.