Questa pagina descrive come gestire le informazioni sui prodotti dopo aver importato un catalogo in Vertex AI Search per la vendita al dettaglio. Puoi leggere, scrivere ed eliminare i prodotti nel tuo catalogo.
Per mantenere il catalogo aggiornato man mano che le informazioni sui prodotti cambiano, importa il catalogo come la prima volta. Per assistenza con l'importazione del catalogo, consulta Importazione delle informazioni del catalogo.
Tutorial per creare/ottenere/aggiornare/eliminare un prodotto
Questo tutorial mostra come utilizzare i metodi API, che eseguono le seguenti azioni:
- Creare un prodotto
- Ottieni un prodotto
- Aggiorna un prodotto
- Elimina un prodotto
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:
Tutorial sulla creazione di un prodotto
Questo tutorial ti mostra come creare un singolo prodotto.
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:
Tutorial per ottenere un prodotto
Questo tutorial mostra come recuperare un articolo di prodotto.
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:
Tutorial sull'aggiornamento del prodotto
Questo tutorial ti mostra come aggiornare un prodotto in un catalogo.
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:
Tutorial sull'eliminazione di un prodotto
Questo tutorial mostra come eliminare un prodotto da un catalogo.
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:
Carica un prodotto
curl
Crea un singolo articolo di prodotto utilizzando il metodo RESTproducts.create
.
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, viene restituito l'oggetto di prodotto, come nell'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 in tempo reale le modifiche apportate ai prodotti, ad esempio nuovi prodotti, prezzi e stato delle scorte. Puoi caricare solo i prodotti che sono stati aggiunti o modificati; non è necessario ricaricare l'intero catalogo.
curl
Aggiorna le informazioni sul prodotto utilizzando il metodoproducts.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, viene restituito l'oggetto di prodotto, come nell'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 fornisca un modo per eliminare prodotti dal catalogo, tieni presente che se registri un evento utente relativo a un elemento del prodotto che è stato eliminato, l'API non può elaborare correttamente l'evento utente e potrebbe essere eliminato. Inoltre, l'inclusione dei dati storici del catalogo migliora la qualità del modello ed è fondamentale per ottenere buoni risultati di ricerca e suggerimenti.
Dovresti impostare il valore availability
dei prodotti obsoleti su OUT_OF_STOCK
anziché eliminarli.
curl
Elimina un prodotto utilizzando il metodo 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
Recupera un articolo di prodotto
curl
Puoi recuperare un articolo di prodotto effettuando una richiesta GET
all'endpoint
products
, sostituendo PRODUCT_ID con l'ID
del prodotto che vuoi 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 tuo catalogo e visualizzare l'anteprima dei prodotti caricati nella scheda Catalogo della pagina Dati della console Search for Retail.
Valuta 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 è necessario aggiornare i dati del catalogo per migliorare la qualità dei risultati di ricerca e sbloccare livelli di prestazioni della ricerca.
Per saperne di più su come controllare la qualità dei dati di ricerca e visualizzare i livelli di rendimento della ricerca, consulta Sbloccare i livelli di prestazioni della ricerca.
Per un riepilogo delle metriche disponibili per il catalogo, consulta Metriche relative alla qualità del catalogo.
Modificare i tipi di prodotto
Quando importi un prodotto, puoi specificare se il tipo è principale, una variante o una collezione. Se il tipo di un 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
nella
documentazione di riferimento.
Modificare 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 del prodotto cambiano o sono stati specificati in modo errato, utilizza la procedura riportata di seguito per correggerne la configurazione. Per completare questa procedura, devi disporre del ruolo IAM Amministratore retail.
Assicurati che non vengano eseguite importazioni durante la riconfigurazione dei livelli dei prodotti. Ciò garantisce che i dati non vengano caricati a un livello errato.
Elimina tutti gli elementi del prodotto. Vedi
products.delete
. Il catalogo deve essere completamente vuoto prima di procedere con il passaggio successivo.Importa nuovamente i dati per modificare la configurazione a livello di prodotto.
Questa procedura dipende da come esegui l'importazione. Segui la procedura appropriata descritta in Importare le informazioni del catalogo per impostare i livelli di prodotto in base alla nuova configurazione.
Completa l'importazione del nuovo catalogo con la configurazione a livello modificato, utilizzando la procedura scelta in Importa informazioni del catalogo.
Ottimizza tutti i modelli esistenti.
Per ottimizzare un modello, vai alla pagina Modelli, fai clic sul nome del modello per visualizzarne la pagina dei dettagli, quindi fai clic su Ottimizzazione manuale nella barra dei pulsanti.
Per i dettagli dei costi di ottimizzazione, consulta la sezione Prezzi.