In questa pagina viene descritto come gestire le informazioni sui prodotti dopo aver importato un catalogo in Vertex AI Search for Retail. Puoi leggere, scrivere e Eliminare prodotti dal catalogo.
Per mantenere aggiornato il catalogo man mano che le informazioni sui prodotti cambiano, importa il catalogo è come la primissima volta. Per assistenza per l'importazione dei tuoi catalogo, consulta la sezione Importare le informazioni del catalogo.
Tutorial per creare/ottenere/aggiornare/eliminare un prodotto
Questo tutorial mostra come utilizzare l'API che eseguono le seguenti azioni:
- Creare un prodotto
- Ottieni un prodotto
- Aggiornare un prodotto
- Elimina un prodotto
Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:
Tutorial sulla creazione di un prodotto
Questo tutorial mostra come creare un singolo prodotto.
Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:
Tutorial per ottenere un prodotto
Questo tutorial mostra come recuperare un articolo del prodotto.
Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:
Tutorial sull'aggiornamento del prodotto
Questo tutorial mostra come aggiornare un prodotto in un catalogo.
Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:
Tutorial sull'eliminazione di un prodotto
Questo tutorial mostra come eliminare un prodotto da un catalogo.
Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:
Carica un prodotto
curl
Crea un singolo articolo di prodotto utilizzando la proprietàproducts.create
Metodo REST.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "title": "PRODUCT_TITLE", "categories": "CATEGORY" }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productId=PRODUCT_ID"
Se la richiesta ha esito positivo, l'oggetto di prodotto viene restituito, come nel caso di dall'esempio seguente.
{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID", "id": "PRODUCT_ID", "primaryProductId": "PRODUCT_ID", "type": "PRIMARY", "categories": [ "CATEGORY" ], "title": "PRODUCT_TITLE", "availability": "IN_STOCK" }
Java
Aggiorna le informazioni sul prodotto
Man mano che il catalogo dei prodotti cambia, puoi aggiornarlo caricando variazioni dei prodotti, ad esempio nuovi prodotti, prezzi e stato delle scorte in tempo reale nel tempo. Puoi caricare solo i prodotti che sono stati aggiunti o modificati. sì non devi ricaricare l'intero catalogo.
curl
Aggiorna le informazioni sul prodotto utilizzando ilproducts.patch
.
L'esempio seguente aggiorna il titolo di un prodotto specifico:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ "title": "new-title-value" }" \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID?updateMask=title"
Se la richiesta ha esito positivo, l'oggetto di prodotto viene restituito, come nel caso di dall'esempio seguente.
{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID", "id": "PRODUCT_ID", "primaryProductId": "PRODUCT_ID", "type": "PRIMARY", "categories": [ "Parent category > Child category" ], "title": "new product title", "availability": "IN_STOCK" }
Java
Eliminare le informazioni sul prodotto
Sebbene l'API offra un modo per eliminare i prodotti dal tuo catalogo, tieni presente che se registri un evento utente relativo a un prodotto un elemento che è stato eliminato, l'API non può elaborare l'utente correttamente e potrebbe essere eliminato. Inoltre, l'inclusione dei dati storici i dati del catalogo migliorano la qualità del modello ed è fondamentale per ottenere consigli e risultati di ricerca.
Devi impostare availability
dei prodotti obsoleti su OUT_OF_STOCK
anziché eliminarli.
curl
Elimina un prodotto utilizzando
delete
sostituendo PRODUCT_ID con l'ID del prodotto che vuoi
eliminare.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
Java
Recuperare un articolo del prodotto
curl
Puoi recuperare un articolo del prodotto effettuando una richiesta GET
alla
Endpoint products
, sostituendo PRODUCT_ID con l'ID
del prodotto che desideri recuperare:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID"
Dovresti vedere un output simile al seguente:
{ "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products/PRODUCT_ID" "id": "PRODUCT_ID", "primaryProductId": "PRODUCT_ID", "type": "PRIMARY", "categories": [ "Parent category > Child category" ], "title": "product title", "availability": "IN_STOCK" }
Java
Visualizzare informazioni aggregate sul tuo catalogo
Puoi visualizzare informazioni aggregate sul catalogo e visualizzare l'anteprima caricata prodotti nella scheda Catalogo nella pagina Dati della console di Search for Retail.
Valutare la qualità dei dati del catalogo
Per valutare la qualità dei dati del tuo catalogo:
Vai alla pagina Qualità dei dati nella console di Search for Retail.
Vai alla pagina Qualità dei datiLa pagina Qualità dei dati valuta se devi aggiornare i dati del catalogo per migliorare la qualità risultati di ricerca e sblocca i livelli delle prestazioni della ricerca.
Per saperne di più su come controllare la qualità dei dati di ricerca e visualizzare il rendimento della ricerca consulta l'articolo Sbloccare i livelli di rendimento della ricerca.
Per un riepilogo delle metriche di catalogo disponibili, vedi Metriche di qualità del catalogo.
Modifica tipi di prodotto
Quando importi un prodotto, puoi specificare se il tipo di prodotto è primario, una variante o una collezione. Se il tipo di prodotto cambia o è stato specificato in modo errato, devi eliminare il prodotto e crearlo con il tipo aggiornato specificato.
Il tipo di prodotto può essere impostato su TYPE_UNSPECIFIED
, PRIMARY
, VARIANT
o
COLLECTION
. Per maggiori dettagli, consulta product.Type
nel
documentazione di riferimento.
Modifica la configurazione a livello di prodotto
Quando importi un catalogo con Merchant Center, devi specificare se i prodotti sono primari o varianti. Se questi livelli di prodotto cambiano o sono stati specificati in modo errato, utilizza seguente per correggerne la configurazione. Devi disporre dei Amministratore Retail per completare questa procedura.
Assicurati che non vengano eseguite importazioni durante la riconfigurazione del prodotto diversi. In questo modo si garantisce che i dati non vengano caricati al livello sbagliato.
Elimina tutti gli articoli del prodotto. Vedi
products.delete
. Il catalogo deve essere completamente vuoto prima di procedere con il passaggio successivo.Importa di nuovo i dati per modificare la configurazione a livello di prodotto.
Questa procedura dipende dal metodo di importazione. Segui la procedura appropriata in Import Catalog Information (Importa informazioni del catalogo) per impostare i livelli del prodotto su la nuova configurazione.
Completa l'importazione del nuovo catalogo con la configurazione a livello modificato, utilizzando procedura scelta in Importare informazioni del catalogo.
Ottimizza tutti i modelli esistenti.
Per ottimizzare un modello, vai alla pagina Modelli e fai clic sul modello per visualizzarne la pagina dei dettagli, poi fai clic su Ottimizzazione manuale nella barra dei pulsanti.
Per i dettagli dei costi di ottimizzazione, consulta la pagina Prezzi.