Il modello Tag Recognizer ti aiuta a risolvere i problemi principali per comprendere la tua sezione di vendita al dettaglio, ovvero a riconoscere e analizzare i tag (ad esempio il cartellino del prezzo o altri tag delle etichette) in base allo schema di estrazione delle entità delle coppie chiave-valore definito dall'utente.
Questo modello può fungere da componente di base dell'IA per analizzare e interpretare i dati delle immagini dei prodotti nei negozi di vendita al dettaglio. Ad esempio, puoi utilizzare questo modello sulle immagini delle sezioni catturate da fotocamere locali o dispositivi mobili.
Casi d'uso di Tag Recognizer e Product Recognizer
Il modello di riconoscimento dei prodotti e i modelli di riconoscimento dei tag possono essere utilizzati come gli elementi costitutivi principali dell'IA per analizzare e interpretare i dati delle immagini relativi a prodotti e tag trovati nei negozi di vendita al dettaglio, come le immagini di scansione delle scaffali acquisite dalle fotocamere installate o dalle piattaforme / dai dispositivi mobili.
I modelli di riconoscimento dei prodotti e dei tag incorporano diverse funzionalità di dati e modellazione dell'IA di Google per aiutare i rivenditori e/o i partner tecnici a risolvere i problemi chiave per comprendere la sezione dei prodotti in un negozio, tra cui:
- Rilevamento, riconoscimento e comprensione dei prodotti presenti nell'immagine o nella sezione.
- Rilevamento, riconoscimento e analisi dei tag (ad esempio il tag prezzo o qualsiasi altro tag di etichetta di testo) in base allo schema di estrazione delle entità delle coppie chiave-valore definito dall'utente.
In particolare, nella soluzione di controllo degli scaffali sono inclusi diversi modelli di IA di Google che si distinguono per supportare la risoluzione dei problemi di questi casi d'uso, ad esempio
- Modelli di rilevamento dei prodotti (preaddestrati da Google, ma che puoi comunque personalizzare).
- Modello di embedding visivo delle miniature dei prodotti, che trasforma un'immagine della miniatura del prodotto in una rappresentazione dello spazio delle funzionalità numeriche.
- Il modello OCR di Google, che estrae tutti i testi visibili nell'immagine.
- Il modello di estrazione di entità di Google (che puoi personalizzare), che trasforma i testi non elaborati in entità denominate con coppie chiave-valore definite dall'utente.
Oltre a questi modelli di IA di Google, la soluzione di controllo degli scaffali sfrutta anche l'ampio database di informazioni sui prodotti di Google. I dati di prodotto in questo database includono l'identità GTIN / UPC, il brand, il titolo e le descrizioni in più lingue, il logo e le immagini del prodotto con varie varianti di confezione. Il database dei prodotti con il modello di embedding visivo delle miniature dei prodotti menzionato in precedenza consente al modello di riconoscimento dei prodotti di riconoscere immediatamente molti prodotti.
Ad esempio, data un'immagine della sezione acquisita come segue, la soluzione di controllo della sezione ha lo scopo di:
- Rileva e localizza tutte le scatole degli articoli del prodotto (visibili, non completamente coperte) nella foto e riconosci l'identità del prodotto di ogni singola scatola dell'articolo del prodotto a livello di GTIN / UPC.
- Rileva e localizza tutte le caselle dei tag (visibili) nell'immagine, riconosci tutte le stringhe di testo nel tag e prova a analizzare il testo nello schema di estrazione delle entità di coppia chiave-valore definito dall'utente, ad esempio la descrizione dell'articolo del prodotto, il valore del prezzo.
Le due principali funzionalità di IA per abilitare queste soluzioni sono il modello di riconoscimento dei prodotti e il modello di riconoscimento dei tag, di cui daremo maggiori dettagli nelle sezioni seguenti. Per ognuna di queste due API che forniscono principalmente i servizi di interpretazione delle immagini, sono presenti uno o più componenti che puoi personalizzare. Descriveremo innanzitutto il percorso di inferenza dell'utilizzo dell'API, quindi forniremo una breve descrizione di come puoi personalizzare i componenti coinvolti, tramite una configurazione utente o tramite l'addestramento di un modello.
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à delle coppie chiave-valore definito dall'utente, ad esempio la descrizione dell'articolo o il valore del prezzo. Sono inclusi i seguenti modelli di IA di Google che si distinguono per:
- 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 con coppie chiave-valore definite dall'utente. Personalizza questo modello utilizzando Vertex AI. Ad esempio, se ti interessano principalmente la descrizione dell'articolo, il valore del prezzo del prodotto o il prezzo scontato, ma non altro, puoi definire lo schema di analisi dei tag come segue:
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 del tag rilevato verrà riconosciuta e analizzata in conformità con lo schema definito dall'utente, ad esempio come segue:
item_description: COLLECTION 18PC GFT BX
regular_price: 1099
sale_price: 999
Oggetto JSON di output di esempio
{
"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 di specificare esplicitamente il nome/l'ID della risorsa da creare. Puoi utilizzare un identificatore di stringhe significativo, ad esempio "product-ABC", o un identificatore generato in modo casuale, ad esempio un UUID.
Per concedere a un ruolo una persona l'accesso in qualità di editor per utilizzare l'API Store Vision, esegui il seguente comando di associazione 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 in qualità di editor, utilizza il seguente comando:
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:SERVICE_ACCOUNT' --role='roles/visionai.editor'
Scopri di più sull'associazione IAM.
Percorso dell'utente di Tag Recognizer
- Esegui l'addestramento personalizzato del modello di rilevamento dei tag utilizzando la funzionalità Rilevamento di oggetti di Vertex AI/AutoML Vision.
- Esegui l'addestramento del modello di analisi del testo per i tag utilizzando la funzionalità di rilevamento di oggetti Vertex AI/AutoML Vision con un motore OCR personalizzato.
- Crea un endpoint con la configurazione di riconoscimento dei tag che preferisci.
- Esegui BatchAnalyze con la funzionalità TagRecognition. Nel backend, il sistema identificarà i tag di ogni immagine di input, analizzerà il testo su ogni tag rilevato per produrre un output di analisi strutturata. T ## Addestramento del modello di rilevamento dei tag e analisi delle entità
Puoi addestrare il modello di rilevamento dei tag personalizzato utilizzando la funzionalità di addestramento del modello di rilevamento degli oggetti di immagine del nostro prodotto Vertex AI/ AutoML Vision. Anche se la funzionalità di addestramento del modello Vertex AI / AutoML Vision Object Detection offre un'esperienza di addestramento del modello completamente gestita, è comunque tua responsabilità preparare un set di dati di immagini ben campionato con annotazioni delle caselle delimitanti degli oggetti completamente etichettate come set di dati di addestramento da inviare alla console di addestramento del modello. Google Cloud fornisce il servizio di etichettatura dei dati di Vertex AI per consentirti di creare l'attività di etichettatura dei dati. Per maggiori dettagli, segui il seguente link al job di etichettatura dati di 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 per il rilevamento dei tag nelle immagini durante la preparazione del set di dati di addestramento.
Per addestrare il modello di analisi del testo dei tag, devi preparare una raccolta di dati di addestramento, con le immagini e le relative annotazioni.
- L'immagine è l'immagine del tag già ritagliata.
- In ogni immagine, devi definire e fornire il campo dell'entità chiave (ad es. i campi product_title, price, unit_price) che vuoi rilevare e riconoscere/analizzare e la posizione delle coordinate della casella delimitante dell'immagine associata in questa visualizzazione dell'immagine ritagliata.
- Per supportare il riconoscimento / l'analisi sintattica corretti, ti chiediamo anche di fornire la sintassi dell'espressione regolare per caratterizzare ogni campo. Questo è necessario per supportare la routine di addestramento e inferenza dell'algoritmo di analisi dei tag.
Esempio di addestramento per l'analisi del parsing delle entità dei tag
Ad esempio, con l'esempio di addestramento precedente per l'analisi dell'entità del tag, puoi fornire una riga di informazioni sulle annotazioni 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}"
Nell'esempio precedente:
- Il campo "product_title" ha la coordinata dell'immagine della casella corrispondente "(x0, y0, x1, y1)" e il vincolo dell'espressione regolare per questo campo è none "".
- Il campo "price" ha la coordinata dell'immagine della casella corrispondente "(x0, y0, x1, y1)" e il vincolo dell'espressione regolare per questo campo è "\$\d+\.\d{2}", che indica che stiamo cercando di riconoscere e analizzare questo campo con il segno $ all'inizio dell'inserimento di testo e alcune cifre 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 della casella "(x0, y0, x1, y1)" e il vincolo dell'espressione regolare per questo campo è "\$\d+\.\d{2}", che indica che stiamo cercando di 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 di entità di etichette dei prezzi adeguato conterranno una raccolta di immagini di etichette dei prezzi, 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 del tagging delle entità personalizzato utilizzando la funzionalità di addestramento del modello di rilevamento di oggetti nelle immagini del nostro prodotto Vertex AI /AutoML Vision esistente, oltre alla personalizzazione dell'engine OCR di Google.
Tieni presente che, a partire da luglio 2022, l'addestramento e il deployment di modelli personalizzati di rilevamento di tag e analisi di entità di tag nell'API BatchAnalyze di Store Vision AI non sono ancora supportati completamente come esperienza di console integrata, ma puoi comunque usufruire di questo addestramento personalizzato dei modelli di rilevamento di tag e analisi di entità di tag (utilizzando la funzionalità di rilevamento di oggetti di Vertex AI Vision) e pubblicarli nell'API BatchAnalyze di Store Vision AI seguendo diversi passaggi di self-service manuale.
Utilizzo dell'API - analisi dell'inferenza batch
Crea endpoint
- ENDPOINT_ID=l'ID del tuo endpoint
- TAG_DETECTOR=nome del modello di rilevamento dei tag
- TAG_PARSER=Il nome del modello di analisi del tag
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 è solo un URI Cloud Storage dell'immagine da elaborare, ad esempio gs://my-bucket/my-image.jpg
- OUTPUT_URI_PREFIX=prefisso URI Cloud Storage per il file dei risultati di output, ad esempio 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"
}
}
],
Esistono anche altri campi che puoi impostare e configurare in tagRecognitionConfig, che è un oggetto RetailTagRecognitionConfig. Per ulteriori dettagli, consulta la descrizione della risorsa nel riferimento all'API.
Riferimento API
Risorsa: projects.locations.retailCatalogs
Rappresentazione JSON
{
"name": string,
"displayName": string,
"createTime": string,
"updateTime": string,
"resourceState": enum(RetailResourceState),
"labels": {
string: string,
...
}
}
Campi
nome |
Stringa |
Solo output. Nome della risorsa del catalogo di vendita al dettaglio |
|---|---|---|
displayName |
Stringa |
Facoltativo. Nome visualizzato di RetailCatalog. |
createTime |
stringa (formato Timestamp) |
Solo output. Timestamp della creazione di questo RetailCatalog. |
updateTime |
stringa (formato Timestamp) |
Solo output. Il timestamp dell'aggiornamento. |
resourceState |
enum |
Solo output. Stato del RetailCatalog. |
etichette |
mappa (chiave: stringa, valore: stringa) |
Le etichette con metadati definiti dall'utente per organizzare il tuo RetailCatalog. Le chiavi e i valori delle etichette 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": "chiave", "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
| principale | 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 appena creata di
RetailCatalog.
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
| principale | 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 viene specificato, il server sceglierà un valore predefinito appropriato. |
| orderBy | string | Facoltativo. Un elenco separato da virgole di campi per ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordinamento 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. RetailCatalog. |
Corpo della richiesta
Rappresentazione JSON
{
"gcsSource": { object(GcsSource) },
"format": enum(Format)
}
Campi
| gcsSource | oggetto | Obbligatorio. La posizione Cloud Storage per i contenuti di input.
È possibile fornire più posizioni di input. I contenuti di tutte le directory 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 da importare. |
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
nome |
Stringa |
Solo output. Nome della risorsa di RetailProductImage |
|---|---|---|
displayName |
Stringa |
Facoltativo. Nome visualizzato di RetailProductImage. |
sourceType |
enum |
Facoltativo. Tipo di origine |
gcsUri |
stringa |
Facoltativo. Percorso di Cloud Storage di RetailProductImage. Deve essere impostato, tranne quando l'immagine è fornita da Google, ad esempio quando il tipo di origine è SOURCE_TYPE_GOOGLE. |
resourceState |
enum |
Solo output. Stato di RetailProductImage. |
etichette |
mappa (chiave: stringa, valore: stringa) |
Le etichette con metadati definiti dall'utente per organizzare RetailProductImage. Le chiavi e i valori delle etichette 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": "chiave", "mass": "1.3kg", "count": "3" }. |
createTime |
stringa (formato Timestamp) |
Solo output. Il timestamp della creazione. |
updateTime |
stringa (formato Timestamp) |
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 es. SKU o MPN). |
| proprietario | string | L'entità che "possiede" l'identificatore di terze parti, ad esempio il produttore o il rivenditore che vende il prodotto. |
Metodo: projects.locations.retailCatalogs.retailProducts.create
Richiesta HTTP
POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProducts
Parametri del percorso
| principale | 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 appena creata di
RetailProduct.
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
| principale | 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 viene specificato, il server sceglierà un valore predefinito appropriato. |
| orderBy | string | Facoltativo. Un elenco separato da virgole di campi per ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordinamento 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
nome |
Stringa |
Solo output. Nome della risorsa di RetailProductImage |
|---|---|---|
displayName |
Stringa |
Facoltativo. Nome visualizzato di RetailProductImage. |
sourceType |
enum |
Facoltativo. Tipo di origine |
gcsUri |
stringa |
Facoltativo. Percorso di Cloud Storage di RetailProductImage. Deve essere impostato, tranne quando l'immagine è 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. Le chiavi e i valori delle etichette 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": "chiave", "mass": "1.3kg", "count": "3" }. |
createTime |
stringa (formato Timestamp) |
Solo output. Il timestamp della creazione. |
updateTime |
stringa (formato Timestamp) |
Solo output. Il timestamp dell'aggiornamento. |
Valori ENUM di SourceType
| SOURCE_TYPE_UNSPECIFIED | Origine dati sconosciuta. Non deve essere utilizzato. |
|---|---|
| SOURCE_TYPE_FIXED_CAMERA | L'immagine viene acquisita da una fotocamera fissa. |
| SOURCE_TYPE_HAND_HELD_CAMERA | L'immagine viene acquisita con una fotocamera 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
| principale | 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 appena creata di
RetailProductImage.
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
| principale | 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 viene specificato, il server sceglierà un valore predefinito appropriato. |
| orderBy | string | Facoltativo. Un elenco separato da virgole di campi per ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordinamento 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
nome |
Stringa |
Solo output. Nome della risorsa del set di prodotti di vendita al dettaglio |
|---|---|---|
displayName |
Stringa |
Facoltativo. Nome visualizzato del 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 del RetailProductSet. |
etichette |
mappa (chiave: stringa, valore: stringa) |
Le etichette con metadati definiti dall'utente per organizzare il set di prodotti di vendita al dettaglio. Le chiavi e i valori delle etichette 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": "chiave", "mass": "1.3kg", "count": "3" }. |
createTime |
stringa (formato Timestamp) |
Solo output. Il timestamp della creazione. |
updateTime |
stringa (formato Timestamp) |
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
| principale | 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 appena creata di RetailProductSet.
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 di 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
| principale | 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 viene specificato, il server sceglierà un valore predefinito appropriato. |
| orderBy | string | Facoltativo. Un elenco separato da virgole di campi per ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordinamento 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 di 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 prodotti di vendita al dettaglio da aggiungere. Devono appartenere allo stesso RetailCatalog del RetailProductSet di destinazione specificato. In una richiesta è possibile specificare fino a 200 ID RetailProducts. Non può essere utilizzato insieme a productFilter. |
|---|---|---|
productFilter |
stringa |
Un filtro standard che verrà applicato a tutti i RetailProducts 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 prodotti di vendita al dettaglio da rimuovere. Se i prodotti di vendita al dettaglio specificati non appartengono a questo set di prodotti di vendita al dettaglio, verranno ignorati. In una richiesta è possibile specificare fino a 200 ID RetailProducts. Non può essere utilizzato insieme a products_filter. |
|---|---|---|
productFilter |
stringa |
Un filtro standard che verrà applicato a tutti i RetailProducts 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
nome |
Stringa |
Solo output. Nome della risorsa RetailProductRecognitionIndex. |
|---|---|---|
displayName |
Stringa |
Facoltativo. Nome visualizzato dell'indice RetailProductRecognitionIndex. |
descrizione |
Stringa |
Facoltativo. La descrizione di RetailProductRecognitionIndex. |
retailProductSet[] |
stringa |
Facoltativo. Il nome della risorsa RetailProductSet da utilizzare per creare questa risorsa. Se impostato, l'indice RetailProductRecognition 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 RetailProductRecognitionIndex. Le chiavi e i valori delle etichette 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": "chiave", "mass": "1.3kg", "count": "3" }. |
createTime |
stringa (formato Timestamp) |
Solo output. Il timestamp della creazione. |
updateTime |
stringa (formato Timestamp) |
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
| principale | 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 appena creata di
RetailProductRecognitionIndex.
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
| principale | 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 viene specificato, il server sceglierà un valore predefinito appropriato. |
| orderBy | string | Facoltativo. Un elenco separato da virgole di campi per ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordinamento 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 di 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
nome |
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 dell'indice ProductRecognitionDeployment in questo RetailEndpoint. |
productRecognitionConfig |
Oggetto |
Facoltativo. Configurazione per il riconoscimento dei prodotti. |
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 RetailProductRecognitionIndex. Le chiavi e i valori delle etichette 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": "chiave", "mass": "1.3kg", "count": "3" }. |
createTime |
stringa (formato Timestamp) |
Solo output. Il timestamp della creazione. |
updateTime |
stringa (formato Timestamp) |
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 di sistema. |
| recognitionConfidenceThreshold | float | Facoltativo. Soglia di confidenza per filtrare i risultati di riconoscimento. Se non viene impostato, verrà utilizzato un valore predefinito di sistema. |
| additionalConfig | object (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 nei 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 di sistema. |
| parsingConfidenceThreshold | float | Facoltativo. Soglia di confidenza per filtrare i risultati dell'analisi del testo. Se non viene impostato, verrà utilizzato un valore predefinito di sistema. |
| additionalConfig | object (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
| principale | 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 appena creata di
RetailEndpoint.
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
| principale | 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 viene specificato, il server sceglierà un valore predefinito appropriato. |
| orderBy | string | Facoltativo. Un elenco separato da virgole di campi per ordinare in ordine crescente. Utilizza "desc" dopo il nome di un campo per l'ordinamento 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 risorsaRetailProductRecognitionIndex
da 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 il 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 del 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. La posizione Cloud Storage per i contenuti di input. È possibile fornire più posizioni di input. I contenuti di tutte le posizioni di input verranno elaborati in un unico batch. Contenuti supportati: un file TXT, ogni riga è il percorso completo di un'immagine. In una richiesta è possibile supportare un massimo di 50.000 immagini. |
|---|---|---|
| outputGcsDestination | string | Facoltativo. La posizione di 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 delle annotazioni. Nel formato "projects/*/datasets/*/tables/*". Se impostato, le annotazioni generate dall'inferenza ML verranno esportate anche 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. Sostituzioni per richiesta per la funzionalità di riconoscimento del prodotto. È attivo solo se il tipo è impostato su TYPE_PRODUCT_RECOGNITION. |
| tagRecognitionConfig | oggetto | Facoltativo. Sostituzioni 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 percorsi 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 di cui è stato eseguito il deployment. |
| 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 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. |
| RETAIL_RESOURCE_STATE_CREATED | Stato creato. |
| RETAIL_RESOURCE_STATE_UPDATING | Aggiornamento stato. |
| RETAIL_RESOURCE_STATE_DELETED | Stato Eliminato. |
| RETAIL_RESOURCE_STATE_ERROR | Stato Errore. |