Guida al riconoscimento tag

Il modello Tag Recognizer ti aiuta a risolvere i problemi principali nella comprensione dello scaffale del tuo negozio, ovvero a riconoscere e analizzare i tag (ad esempio il cartellino del prezzo o altri tag etichetta) in base allo schema di estrazione delle entità della coppia chiave-valore definito dall'utente.

Questo modello può fungere da componenti di base per l'AI per analizzare e interpretare i dati delle immagini dei prodotti nei negozi al dettaglio. Ad esempio, puoi utilizzare questo modello sulle immagini degli scaffali acquisite da videocamere locali o dispositivi mobili.

Casi d'uso del riconoscimento tag e del riconoscimento dei prodotti

I modelli Product Recognizer e Tag Recognizer possono fungere da elementi di base dell'AI per analizzare e interpretare i dati immagine relativi a prodotti e tag, che potresti aver acquisito dai negozi al dettaglio.

I modelli di riconoscimento dei prodotti e dei tag incorporano diverse funzionalità di modellazione e dati di base di Google AI per aiutare i rivenditori e/o i partner tecnici a risolvere i problemi principali nella comprensione dei dati delle immagini di prodotti ed etichette dei prezzi, tra cui:

Riconoscimento, ovvero la comprensione di quale prodotto è presente nell'immagine.
Riconoscimento e analisi del tag (ad esempio, il cartellino del prezzo o qualsiasi altro tag di etichetta di testo) in base allo schema di estrazione delle entità della coppia chiave-valore definita dall'utente.

In particolare, sono inclusi diversi modelli di Google AI differenziati per supportare la risoluzione dei problemi di questi casi d'uso, ad esempio

Modello di incorporamento visivo delle miniature dei prodotti, che trasforma un'immagine della miniatura del prodotto in una rappresentazione numerica dello spazio delle funzionalità.
Il modello OCR di Google, che estrae tutti i testi visibili nell'immagine.
Modello di estrazione delle entità di Google (che puoi personalizzare), che trasforma i testi non elaborati in entità denominate coppie chiave-valore definite dall'utente.

Oltre a questi modelli di Google AI, il sistema di riconoscimento dei prodotti sfrutta anche l'ampio database di informazioni sui prodotti di Google. I dati di prodotto in questo database dei prodotti includono l'identità GTIN / UPC del prodotto, il brand del prodotto, il titolo e le descrizioni in varie lingue, il logo del prodotto e le immagini con varie varianti di packaging. Il database dei prodotti con il modello di incorporamento visivo delle miniature dei prodotti menzionato in precedenza consente al modello di riconoscimento dei prodotti di riconoscere immediatamente molti prodotti.

Le due principali funzionalità di AI sono i modelli di riconoscimento dei prodotti e di riconoscimento dei tag.

Funzionalità di riconoscimento tag

Questo modello riconosce tutte le stringhe di testo nel tag e poi tenta di analizzare il testo nello schema di estrazione delle entità della coppia chiave-valore definita dall'utente, ad esempio la descrizione o il prezzo di un articolo prodotto. Include i seguenti modelli di Google AI differenziati:

La tecnologia OCR di Google, che estrae tutto il testo visibile nell'immagine.
Il modello di estrazione di entità di Google che trasforma il testo non elaborato in entità denominate coppie chiave-valore definite dall'utente. Personalizza questo modello utilizzando Vertex AI. Ad esempio, se ti interessano principalmente la descrizione dell'articolo di prodotto, il valore del prezzo del prodotto o il prezzo scontato, ma nient'altro, l'utente può definire lo schema di analisi dei tag nel seguente modo:
```
key: item_description   value: string
key: regular_price      value: number
key: sale_price         value: number
```

Schema di analisi dei tag

Con l'addestramento del modello di estrazione delle entità personalizzato, la casella dell'elemento tag rilevato verrà quindi riconosciuta e analizzata in conformità allo schema definito dall'utente, ad esempio nel seguente modo:

  item_description:   COLLECTION 18PC GFT BX
  regular_price:      1099
  sale_price:         999

Esempio di oggetto JSON di output

{
  "imageUri": "gs://test_bucket/test_image.jpg",
  "tagRecognitionAnnotations": [
    {
      "entities": [
        {
          "confidence": 0.99646133,
          "mentionText": "NISSIN TOP RAMEN\n\nBOW CHICKEN\n\n",
          "region": {
            "xMax": 0.4618055,
            "xMin": 0.042725038,
            "yMax": 0.45387268,
            "yMin": 0.18415153
          },
          "type":"description"
        },
        {
          "confidence": 0.95828205,
          "mentionText": "$3.90\n",
          "region": {
            "xMax": 0.24819264,
            "xMin": 0.04185935,
            "yMax": 0.96134734,
            "yMin": 0.80382305
          },
          "type":"unit_price"
        },
        {
          "confidence": 0.60659707,
          "mentionText": "$14.99\n",
          "region": {
            "xMax": 0.9754113,
            "xMin": 0.3654699,
            "yMax": 0.92825794,
            "yMin": 0.40368474
          },
          "type":"price"
        }
      ]
    }
  ]
}

Configurazione dell'ambiente

Questa sezione descrive come interagire con l'API RESTful Store Vision AI.

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

Tutti i metodi create richiedono la specifica esplicita del nome/ID della risorsa da creare. Puoi utilizzare una stringa significativa identificatore, ad esempio "product-ABC" o un identificatore generato in modo casuale, ad esempio UUID.

Per concedere a una persona con ruolo l'accesso di editor per utilizzare l'API Store Vision, esegui il seguente comando di binding IAM:

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

Per concedere a un account di servizio l'accesso come editor, utilizza il comando riportato di seguito:

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

Scopri di più sul binding IAM.

Percorso dell'utente del riconoscimento tag

Esegui l'addestramento personalizzato del modello di rilevamento dei tag utilizzando la funzionalità Vertex AI / AutoML Vision Object Detection.
Esegui l'addestramento del modello di analisi delle entità tag utilizzando la funzionalità Vertex AI/AutoML Vision Object Detection con il motore OCR personalizzato.
Crea un endpoint con la configurazione di riconoscimento tag desiderata.
Esegui BatchAnalyze con la funzionalità TagRecognition. Nel backend, il sistema identificherà i tag di ogni immagine di input, analizzerà il testo di ogni tag rilevato per produrre un output di analisi strutturato. T ## Addestramento del modello di rilevamento dei tag e analisi delle entità

Puoi addestrare il modello personalizzato di rilevamento dei tag utilizzando la funzionalità di addestramento del modello di rilevamento degli oggetti delle immagini del nostro prodotto Vertex AI/AutoML Vision esistente. Sebbene la funzionalità di addestramento del modello Vertex AI / AutoML Vision Object Detection fornisca un'esperienza di addestramento del modello completamente gestita, è comunque tua responsabilità preparare un set di dati di immagini ben campionati con annotazioni delle riquadro di delimitazione degli oggetti completamente etichettate come set di dati di addestramento da inserire nella console di addestramento del modello. Google Cloud fornisce il servizio di etichettatura dei dati Vertex AI per consentirti di creare l'attività di etichettatura dei dati. Per i dettagli, segui il seguente link al job di etichettatura dei dati Vertex AI: /vertex-ai/docs/datasets/data-labeling-job. Fornisci istruzioni chiare per l'etichettatura dei dati ai valutatori umani in modo che sappiano come etichettare i riquadri di delimitazione del rilevamento dei tag nelle immagini durante la preparazione del set di dati di addestramento.

Per addestrare il modello di analisi delle entità dei tag, devi preparare una raccolta di dati di addestramento, con immagini e le relative annotazioni.

L'immagine è quella del tag già ritagliata.
In ogni immagine, devi definire e fornire il campo dell'entità chiave (ad esempio i campi product_title, price, unit_price) che vuoi rilevare e riconoscere/analizzare e la posizione delle coordinate riquadro di delimitazione di selezione dell'immagine associata in questa visualizzazione dell'immagine ritagliata.
Per supportare il riconoscimento / l'analisi corretti, ti chiediamo anche di fornire la sintassi dell'espressione regolare per caratterizzare ogni campo. È necessario per assistere la routine di addestramento e inferenza dell'algoritmo di analisi dei tag.

immagine del tag riconosciuto

Esempio di addestramento per l'analisi delle entità dei tag

Ad esempio, con l'esempio precedente di addestramento dell'analisi delle entità tag, puoi fornire una riga di informazioni sull'annotazione nel file CSV di annotazione dei dati di addestramento come segue:

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

Dall'esempio precedente:

Il campo "product_title" ha le coordinate dell'immagine della casella corrispondente "(x0, y0, x1, y1)" e il vincolo dell'espressione regolare per questo campo è nessuno "".
Il campo "price" (prezzo) ha le coordinate dell'immagine della casella corrispondente "(x0, y0, x1, y1)" e il vincolo dell'espressione regolare per questo campo è "\$\d+\.\d{2}", il che indica che vogliamo riconoscere e analizzare questo campo con il segno $ all'inizio dell'inserimento di testo e alcune cifre numeriche prima del "." e due cifre dopo il ".".
Il campo "unit_price" ha la stessa sintassi di annotazione del campo "price". Ad esempio, le coordinate dell'immagine del riquadro "(x0, y0, x1, y1)" e il vincolo dell'espressione regolare per questo campo è "\$\d+\.\d{2}", che indica che vogliamo riconoscere e analizzare questo campo con il segno $ all'inizio dell'inserimento di testo e alcune cifre prima del "." e due cifre dopo il ".".

Pertanto, i dati di addestramento di un modello di analisi / rilevamento delle entità dei cartellini del prezzo appropriato avranno una raccolta di immagini di cartellini del prezzo, con l'annotazione in un file CSV con ogni voce di riga CSV proprio come la voce nell'esempio precedente.

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

[...]

Puoi addestrare il modello di analisi delle entità dei tag personalizzato utilizzando la funzionalità di addestramento del modello di rilevamento di oggetti delle immagini del nostro prodotto Vertex AI /AutoML Vision esistente, oltre alla personalizzazione del motore Google OCR.

Tieni presente che, a partire da luglio 2022, l'addestramento e il deployment del modello personalizzato di rilevamento dei tag e analisi delle entità tag nell'API BatchAnalyze di Store Vision AI non sono ancora completamente supportati come esperienza di console integrata. Tuttavia, puoi comunque usufruire di questo addestramento del modello personalizzato di rilevamento dei tag e analisi delle entità tag (utilizzando la funzionalità di rilevamento degli oggetti di Vertex AI Vision) e del relativo servizio nell'API BatchAnalyze di Store Vision AI seguendo diversi passaggi manuali self-service.

Utilizzo dell'API - Inferenza di analisi batch

Crea endpoint

ENDPOINT_ID=Your endpoint id
TAG_DETECTOR=Your tag detection model name
TAG_PARSER=Your tag parsing model name

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 '{
  "tagRecognitionConfig": {
    "tag_detection_model": "TAG_DETECTOR_NAME",
    "tag_parsing_model": "TAG_PARSER_NAME"
  }
}'

INPUT_FILE_URI=URI Cloud Storage del file di input. Ogni riga del file di input è un URI Cloud Storage dell'immagine da elaborare, ad esempio gs://my-bucket/my-image.jpg
OUTPUT_URI_PREFIX=Cloud Storage uri prefix for output results file, for example, 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_TAG_RECOGNITION",
     }
  ],
  "outputGcsDestination": {
    "outputUriPrefix": "OUTPUT_URI_PREFIX"
  }
}'

"features": [
    {
      "type": "TYPE_TAG_RECOGNITION",
      "tagRecognitionConfig": {
        "tag_detection_model": "'TAG_DETECTOR_NAME'",
        "tag_parsing_model": "TAG_PARSER_NAME"
      }
    }
  ],

Sono disponibili anche altri campi che puoi impostare e configurare in tagRecognitionConfig, che è un oggetto RetailTagRecognitionConfig. Per ulteriori dettagli, consulta la descrizione della risorsa nel Riferimento API.

Riferimento API

Risorsa: projects.locations.retailCatalogs

Rappresentazione JSON

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

Campi

name	Stringa	Solo output. Nome risorsa di RetailCatalog
displayName	Stringa	(Facoltativo) Nome visualizzato di RetailCatalog.
createTime	string (Timestamp format)	Solo output. Timestamp di creazione di questo RetailCatalog.
updateTime	string (Timestamp format)	Solo output. Il timestamp dell'aggiornamento.
resourceState	enum	Solo output. Stato di RetailCatalog.
etichette	map (key: string, value: string)	Le etichette con i metadati definiti dall'utente per organizzare il catalogo Retail. I valori e le chiavi di etichetta non devono superare i 64 caratteri (punti di codice Unicode) e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. Per ulteriori informazioni ed esempi di etichette, consulta la pagina https://goo.gl/xmQnxf. Un oggetto contenente un elenco di coppie "chiave": valore. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Metodo: projects.locations.retailCatalogs.create

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di RetailCatalog.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailCatalog appena creata.

Metodo: projects.locations.retailCatalogs.get

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailCatalog`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailCatalog.

Metodo: projects.locations.retailCatalogs.list

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Parametri di query

filtro	string	Facoltativo. Un'espressione per filtrare i risultati della richiesta.
pageToken	string	Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
pageSize	integer	Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
orderBy	string	Facoltativo. Un elenco separato da virgole di campi da ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordine decrescente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura: Rappresentazione JSON

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

Metodo: projects.locations.retailCatalogs.delete

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailCatalog`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Metodo: projects.locations.retailCatalogs.importRetailProducts

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Nome della risorsa `RetailCatalog`.

Corpo della richiesta

Rappresentazione JSON

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

Campi

gcsSource	oggetto	Obbligatorio. Il percorso Cloud Storage dei contenuti di input. È possibile fornire più posizioni di input. I contenuti di tutte le posizioni di input verranno importati in un unico batch. Estensioni dei file supportate: 1. Un file JSONL. Ogni riga è un formato JSON di RetailProductIoFormat. 2. Un file TXT. Ogni riga è il GTIN di un prodotto da importare.
formato	enum	Obbligatorio. Il formato del file di importazione.

Formattare i valori ENUM

FORMAT_UNSPECIFIED	Non deve essere utilizzato.
FORMAT_TXT	Formato TXT.
FORMAT_JSONL	Formato JSONL.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Risorsa: projects.locations.retailProducts

Rappresentazione 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
}

Campi

name	Stringa	Solo output. Nome della risorsa RetailProductImage
displayName	Stringa	(Facoltativo) Nome visualizzato di RetailProductImage.
sourceType	enum	(Facoltativo) Tipo di origine
gcsUri	stringa	(Facoltativo) Percorso Cloud Storage di RetailProductImage. Deve essere impostato, tranne quando l'immagine viene fornita da Google, ad esempio quando il tipo di origine è SOURCE_TYPE_GOOGLE.
resourceState	enum	Solo output. Stato di RetailProductImage.
etichette	map (key: string, value: string)	Le etichette con metadati definiti dall'utente per organizzare RetailProductImage. I valori e le chiavi di etichetta non devono superare i 64 caratteri (punti di codice Unicode) e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. Per ulteriori informazioni ed esempi di etichette, visita la pagina https://goo.gl/xmQnxf. Un oggetto contenente un elenco di coppie "chiave": valore. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp format)	Solo output. Timestamp creazione.
updateTime	string (Timestamp format)	Solo output. Il timestamp dell'aggiornamento.

RetailThirdPartyId Presentazione JSON

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

Campi


id	string	ID di terze parti utilizzato dal rivenditore o dal produttore (ad esempio, SKU o MPN).
proprietario	string	L'entità "proprietaria" dell'identificatore di terze parti, ad esempio il produttore o il rivenditore che vende questo prodotto.

Metodo: projects.locations.retailCatalogs.retailProducts.create

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di RetailProduct.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProduct appena creata.

Metodo: projects.locations.retailCatalogs.retailProducts.get

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailProduct`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProduct.

Metodo: projects.locations.retailCatalogs.retailProducts.list

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Parametri di query

filtro	string	Facoltativo. Un'espressione per filtrare i risultati della richiesta.
pageToken	string	Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
pageSize	integer	Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
orderBy	string	Facoltativo. Un elenco separato da virgole di campi da ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordine decrescente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura: Rappresentazione JSON

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

Metodo: projects.locations.retailCatalogs.retailProducts.delete

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailProduct`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Risorsa: projects.locations.retailProductImages

Rappresentazione JSON

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

Campi

name	Stringa	Solo output. Nome della risorsa RetailProductImage
displayName	Stringa	(Facoltativo) Nome visualizzato di RetailProductImage.
sourceType	enum	(Facoltativo) Tipo di origine
gcsUri	stringa	(Facoltativo) Percorso Cloud Storage di RetailProductImage. Deve essere impostato, tranne quando l'immagine viene fornita da Google, ad esempio quando il tipo di origine è SOURCE_TYPE_GOOGLE.
resourceState	enum	Solo output. Stato di RetailProductImage.
etichette	map (key: string, value: string)	Le etichette con metadati definiti dall'utente per organizzare RetailProductImage. I valori e le chiavi di etichetta non devono superare i 64 caratteri (punti di codice Unicode) e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. Per ulteriori informazioni ed esempi di etichette, visita la pagina https://goo.gl/xmQnxf. Un oggetto contenente un elenco di coppie "chiave": valore. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp format)	Solo output. Timestamp creazione.
updateTime	string (Timestamp format)	Solo output. Il timestamp dell'aggiornamento.

Valori ENUM SourceType

SOURCE_TYPE_UNSPECIFIED	Origine dati sconosciuta. Non deve essere utilizzato.
SOURCE_TYPE_FIXED_CAMERA	L'immagine viene acquisita da una videocamera fissa.
SOURCE_TYPE_HAND_HELD_CAMERA	L'immagine viene acquisita da una videocamera portatile.
SOURCE_TYPE_CRAWLED	L'immagine viene sottoposta a scansione dal web.
SOURCE_TYPE_SYSTEM_GENERATED	L'immagine è ritagliata da un'immagine originale con etichettatura umana.

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

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di RetailProductImage.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProductImage appena creata.

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

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailProductImage`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProductImage.

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

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Parametri di query

filtro	string	Facoltativo. Un'espressione per filtrare i risultati della richiesta.
pageToken	string	Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
pageSize	integer	Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
orderBy	string	Facoltativo. Un elenco separato da virgole di campi da ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordine decrescente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON

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

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

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailProductImage`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Risorsa: projects.locations.retailCatalogs.retailProductSets

Rappresentazione JSON

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

Campi

name	Stringa	Solo output. Nome risorsa del RetailProductSet
displayName	Stringa	(Facoltativo) Nome visualizzato di RetailProductSet.
retailProductIds []	Stringa	Solo output. ID risorsa dei prodotti appartenenti a questo RetailProductSet. I prodotti in un RetailProductSet devono trovarsi nello stesso catalogo.
resourceState	enum	Solo output. Stato di RetailProductSet.
etichette	map (key: string, value: string)	Le etichette con metadati definiti dall'utente per organizzare il tuo RetailProductSet. I valori e le chiavi di etichetta non devono superare i 64 caratteri (punti di codice Unicode) e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. Per ulteriori informazioni ed esempi di etichette, visita la pagina https://goo.gl/xmQnxf. Un oggetto contenente un elenco di coppie "chiave": valore. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp format)	Solo output. Timestamp creazione.
updateTime	string (Timestamp format)	Solo output. Il timestamp dell'aggiornamento.

Metodo: projects.locations.retailCatalogs.retailProductSets.create

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di RetailProductSet.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProductSet appena creata.

Metodo: projects.locations.retailCatalogs.retailProductSets.get

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore RetailProductSet.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProductSet.

Metodo: projects.locations.retailCatalogs.retailProductSets.list

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Parametri di query

filtro	string	Facoltativo. Un'espressione per filtrare i risultati della richiesta.
pageToken	string	Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
pageSize	integer	Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
orderBy	string	Facoltativo. Un elenco separato da virgole di campi da ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordine decrescente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON

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

Metodo: projects.locations.retailCatalogs.retailProductSets.delete

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore RetailProductSet.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Metodo: projects.locations.retailCatalogs.retailProductSets.add

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Nome della risorsa RetailProductSet.

Corpo della richiesta

Rappresentazione JSON

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

Campi

productIds[ ]	stringa	ID risorsa dei RetailProducts da aggiungere. Devono appartenere tutti allo stesso RetailCatalog del RetailProductSet di destinazione specificato. È possibile specificare fino a 200 ID RetailProducts in una richiesta. Non può essere utilizzato insieme a productFilter.
productFilter	stringa	Un filtro standard che verrà applicato a tutti i RetailProduct nel RetailCatalog principale, seleziona gli elementi che soddisfano le condizioni del filtro e aggiungili al RetailProductSet. Non può essere utilizzato insieme a product_ids. Filtri supportati: https://google.aip.dev/160

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Metodo: projects.locations.retailCatalogs.retailProductSets.remove

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Nome della risorsa RetailProductSet.

Corpo della richiesta

Rappresentazione JSON

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

Campi

productIds[ ]	stringa	ID risorsa dei RetailProducts da rimuovere. Se RetailProducts specificato non appartiene a questo RetailProductSet, verrà ignorato. È possibile specificare fino a 200 ID RetailProducts in una richiesta. Non può essere utilizzato insieme a products_filter.
productFilter	stringa	Un filtro standard che verrà applicato a tutti i RetailProduct nel RetailProductSet specificato, seleziona gli elementi che soddisfano le condizioni del filtro e rimuovili dal RetailProductSet. Non può essere utilizzato insieme a product_ids. Filtri supportati:https://google.aip.dev/160

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Risorsa: projects.locations.retailCatalogs.retailProductRecognitionIndexes

Rappresentazione JSON

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

Campi

name	Stringa	Solo output. Nome della risorsa RetailProductRecognitionIndex.
displayName	Stringa	(Facoltativo) Nome visualizzato di RetailProductRecognitionIndex.
descrizione	Stringa	(Facoltativo) La descrizione di RetailProductRecognitionIndex.
retailProductSet[]	stringa	(Facoltativo) Il nome della risorsa RetailProductSet da utilizzare per creare questa risorsa. Se impostato, RetailProductRecognitionIndex conterrà solo i prodotti nel RetailProductSet specificato. Se non viene impostato, verranno utilizzati tutti i prodotti del catalogo principale.
resourceState	enum	Solo output. Stato di RetailProductRecognitionIndex.
etichette	map (key: string, value: string)	Le etichette con metadati definiti dall'utente per organizzare l'indice RetailProductRecognition. I valori e le chiavi di etichetta non devono superare i 64 caratteri (punti di codice Unicode) e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. Per ulteriori informazioni ed esempi di etichette, visita la pagina https://goo.gl/xmQnxf. Un oggetto contenente un elenco di coppie "chiave": valore. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp format)	Solo output. Timestamp creazione.
updateTime	string (Timestamp format)	Solo output. Il timestamp dell'aggiornamento.

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.create

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di RetailProductRecognitionIndex.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProductRecognitionIndex appena creata.

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.get

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailProductRecognitionIndex`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailProductRecognitionIndex.

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.list

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Parametri di query

filtro	string	Facoltativo. Un'espressione per filtrare i risultati della richiesta.
pageToken	string	Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
pageSize	integer	Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
orderBy	string	Facoltativo. Un elenco separato da virgole di campi da ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordine decrescente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON

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

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.delete

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore ProductRecognitionIndex.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Risorsa: projects.locations.retailEndpoints

Rappresentazione 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
}

Campi

name	Stringa	Solo output. Nome della risorsa RetailEndpoint.
displayName	Stringa	(Facoltativo) Nome visualizzato di RetailEndpoint.
descrizione	Stringa	(Facoltativo) La descrizione di RetailEndpoint.
deployedProductRecognitionIndex	Stringa	Solo output. Nome della risorsa di ProductRecognitionIndex di cui è stato eseguito il deployment in questo RetailEndpoint.
productRecognitionConfig	oggetto	(Facoltativo) Configurazione per il riconoscimento del prodotto.
tagRecognitionConfig	oggetto	(Facoltativo) Configurazione per il riconoscimento dei tag.
resourceState	enum	Solo output. Stato di RetailProductRecognitionIndex.
etichette	map (key: string, value: string)	Le etichette con metadati definiti dall'utente per organizzare l'indice RetailProductRecognition. I valori e le chiavi di etichetta non devono superare i 64 caratteri (punti di codice Unicode) e possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Sono consentiti caratteri internazionali. Per ulteriori informazioni ed esempi di etichette, visita la pagina https://goo.gl/xmQnxf. Un oggetto contenente un elenco di coppie "chiave": valore. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp format)	Solo output. Timestamp creazione.
updateTime	string (Timestamp format)	Solo output. Il timestamp dell'aggiornamento.

RetailProductRecognitionConfig

Rappresentazione JSON

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

Campi

productDetectionModel	string	Obbligatorio. Modello da utilizzare per rilevare i prodotti nelle immagini di input. Valori supportati: "builtin/stable" (il valore predefinito) o il nome della risorsa del modello Vertex AI.
detectionConfidenceThreshold	float	Facoltativo. Soglia di confidenza per filtrare i risultati del rilevamento. Se non viene impostato, verrà utilizzato un valore predefinito del sistema.
recognitionConfidenceThreshold	float	Facoltativo. Soglia di confidenza per filtrare i risultati del riconoscimento. Se non viene impostato, verrà utilizzato un valore predefinito del sistema.
additionalConfig	oggetto (formato Struct)	Facoltativo. Configurazioni aggiuntive per il riconoscimento dei prodotti.

RetailTagRecognitionConfig

Rappresentazione JSON

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

Campi

tagDetectionModel	string	Obbligatorio. Modello da utilizzare per rilevare i tag nelle immagini di input. Valori supportati: risorsa modello Vertex AI.
tagParsingModel	string	Obbligatorio. Modello per analizzare il testo sui tag rilevati. Valori supportati: risorsa modello Vertex AI.
detectionConfidenceThreshold	float	Facoltativo. Soglia di confidenza per filtrare i risultati del rilevamento. Se non viene impostato, verrà utilizzato un valore predefinito del sistema.
parsingConfidenceThreshold	float	Facoltativo. Soglia di confidenza per filtrare i risultati dell'analisi del testo. Se non viene impostato, verrà utilizzato un valore predefinito del sistema.
additionalConfig	oggetto (formato Struct)	Facoltativo. Configurazioni aggiuntive per il riconoscimento dei tag.

Metodo: projects.locations.retailEndpoints.create

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di RetailEndpoint.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailEndpoint appena creata.

Metodo: projects.locations.retailEndpoints.get

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailEndpoint`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di RetailEndpoint.

Metodo: projects.locations.retailEndpoints.list

Richiesta HTTP

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

Parametri del percorso


genitore	string	Obbligatorio. Identificatore principale.

Parametri di query

filtro	string	Facoltativo. Un'espressione per filtrare i risultati della richiesta.
pageToken	string	Facoltativo. Un token che identifica una pagina di risultati che il server deve restituire.
pageSize	integer	Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
orderBy	string	Facoltativo. Un elenco separato da virgole di campi da ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordine decrescente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON

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

Metodo: projects.locations.retailEndpoints.delete

Richiesta HTTP

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

Parametri del percorso


nome	string	Obbligatorio. Identificatore `RetailEndpoint`.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Metodo: projects.locations.retailEndpoints.deployRetailProductRecognitionIndex

Richiesta HTTP

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

Parametri del percorso


retailEndpoint	string	Obbligatorio. Nome della risorsa `RetailEndpoint` in cui viene eseguito il deployment di `RetailProductRecognitionIndex`.

Corpo della richiesta

Rappresentazione JSON

{
  "retailProductRecognitionIndex": string,
}

Campi


retailProductRecognitionIndex	string	Obbligatorio. Il nome della risorsa di `RetailProductRecognitionIndex` di cui eseguire il deployment.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Metodo: projects.locations.retailEndpoints.undeployRetailProductRecognitionIndex

Richiesta HTTP

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

Parametri del percorso


retailEndpoint	string	Obbligatorio. Nome della risorsa `RetailEndpoint` su cui verrà eseguito l'annullamento del deployment.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Metodo: projects.locations.retailEndpoints.batchAnalyze

Richiesta HTTP

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

Parametri del percorso


retailEndpoint	string	Obbligatorio. Nome della risorsa `RetailEndpoint` per gestire la richiesta di inferenza.

Corpo della richiesta

Rappresentazione 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
}

Campi

gcsSource	string	Obbligatorio. Il percorso Cloud Storage dei contenuti di input. È possibile fornire più posizioni di input. I contenuti di tutte le località di input verranno elaborati in un unico batch. Contenuti supportati: un file TXT in cui ogni riga è il percorso completo di un'immagine. In una richiesta è possibile supportare un massimo di 50.000 immagini.
outputGcsDestination	string	Facoltativo. Il percorso Cloud Storage della directory in cui scrivere l'output.
corpus	string	Facoltativo. Nome della risorsa del corpus del warehouse di immagini. Non ancora supportato.
bigqueryTable	string	Facoltativo. Nome della risorsa della tabella BigQuery per le esportazioni di annotazioni. Nel formato "projects//datasets//tables/*". Se impostate, anche le annotazioni generate dall'inferenza ML verranno esportate nella tabella BigQuery specificata. Non ancora supportato.
features[]	Oggetto	Obbligatorio. Il tipo di inferenza ML da eseguire.

Funzionalità

Rappresentazione JSON

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

Campi

tipo	enum	Obbligatorio. Il tipo di funzionalità.
productRecognitionConfig	oggetto	Facoltativo. Override per richiesta per la funzionalità di riconoscimento dei prodotti. È efficace solo se il tipo è impostato su TYPE_PRODUCT_RECOGNITION.
tagRecognitionConfig	oggetto	Facoltativo. Override per richiesta per la funzionalità di riconoscimento dei tag. È efficace solo se il tipo è impostato su TYPE_TAG_RECOGNITION.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Tipi

GcsSource

Rappresentazione JSON

{
  "uris": [string]
}

Campi


uris[]	string	Obbligatorio. Riferimenti a un percorso Cloud Storage.

Tipo

Valori ENUM

TYPE_UNSPECIFIED	Il valore predefinito. Non deve essere utilizzato.
TYPE_PRODUCT_RECOGNITION	Riconoscimento dei prodotti. Deve essere utilizzato su un `RetailEndpoint` con `RetailProductRecognitionIndex` implementato.
TYPE_TAG_RECOGNITION	Rilevamento e analisi dei tag. Deve essere utilizzato su un `RetailEndpoint` con RetailTagRecognitionConfig.

RetailProductIoFormat

Rappresentazione JSON

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

Campi

retailProduct	oggetto	Obbligatorio. `RetailProduct` da importare
retailProductImages[ ]	oggetto	(Facoltativo) `RetailProductImage`s del `RetailProduct` specificato da importare.

RetailResourceState

Valori ENUM

RETAIL_RESOURCE_STATE_UNSPECIFIED	Il valore predefinito. Non deve essere utilizzato.
RETAIL_RESOURCE_STATE_CREATING	Stato: creazione in corso.
RETAIL_RESOURCE_STATE_CREATED	Stato creato.
RETAIL_RESOURCE_STATE_UPDATING	Aggiornamento dello stato.
RETAIL_RESOURCE_STATE_DELETED	Stato eliminato.
RETAIL_RESOURCE_STATE_ERROR	Errore di stato.

Guida al riconoscimento tag Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Casi d'uso del riconoscimento tag e del riconoscimento dei prodotti

Funzionalità di riconoscimento tag

Schema di analisi dei tag

Esempio di oggetto JSON di output

Configurazione dell'ambiente

Percorso dell'utente del riconoscimento tag

Utilizzo dell'API - Inferenza di analisi batch

Crea endpoint

Riferimento API

Risorsa: projects.locations.retailCatalogs

Metodo: projects.locations.retailCatalogs.create

Metodo: projects.locations.retailCatalogs.get

Metodo: projects.locations.retailCatalogs.list

Metodo: projects.locations.retailCatalogs.delete

Metodo: projects.locations.retailCatalogs.importRetailProducts

Risorsa: projects.locations.retailProducts

Metodo: projects.locations.retailCatalogs.retailProducts.create

Metodo: projects.locations.retailCatalogs.retailProducts.get

Metodo: projects.locations.retailCatalogs.retailProducts.list

Metodo: projects.locations.retailCatalogs.retailProducts.delete

Risorsa: projects.locations.retailProductImages

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

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

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

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

Risorsa: projects.locations.retailCatalogs.retailProductSets

Metodo: projects.locations.retailCatalogs.retailProductSets.create

Metodo: projects.locations.retailCatalogs.retailProductSets.get

Metodo: projects.locations.retailCatalogs.retailProductSets.list

Metodo: projects.locations.retailCatalogs.retailProductSets.delete

Metodo: projects.locations.retailCatalogs.retailProductSets.add

Metodo: projects.locations.retailCatalogs.retailProductSets.remove

Risorsa: projects.locations.retailCatalogs.retailProductRecognitionIndexes

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.create

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.get

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.list

Metodo: projects.locations.retailCatalogs.retailProductRecognitionIndexes.delete

Risorsa: projects.locations.retailEndpoints

RetailProductRecognitionConfig

RetailTagRecognitionConfig

Metodo: projects.locations.retailEndpoints.create

Metodo: projects.locations.retailEndpoints.get

Metodo: projects.locations.retailEndpoints.list

Metodo: projects.locations.retailEndpoints.delete

Metodo: projects.locations.retailEndpoints.deployRetailProductRecognitionIndex

Metodo: projects.locations.retailEndpoints.undeployRetailProductRecognitionIndex

Metodo: projects.locations.retailEndpoints.batchAnalyze

RetailProductIoFormat

Guida al riconoscimento tag