Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Gestire le informazioni di catalogo

Questa pagina descrive come gestire le informazioni sui prodotti dopo aver importato un catalogo in AI Commerce Search. Puoi leggere, scrivere ed eliminare i prodotti nel tuo catalogo.

Per mantenere aggiornato il catalogo man mano che le informazioni sui prodotti cambiano, importa il catalogo nello stesso modo della prima volta. Per assistenza con l'importazione del tuo catalogo, consulta Importare le informazioni del catalogo.

Tutorial per creare, accedere e gestire i prodotti

Questo tutorial mostra come utilizzare i metodi dell'API, che eseguono le seguenti azioni:

Crea 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 Procedura guidata:

Procedura guidata

Crea prodotto

Questo tutorial mostra come creare un singolo prodotto.

Per seguire le indicazioni dettagliate per questa attività direttamente nell' editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Ottieni 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 Procedura guidata:

Procedura guidata

Aggiorna prodotto

Questo tutorial 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 Procedura guidata:

Procedura guidata

Elimina 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 Procedura guidata:

Procedura guidata

Carica un singolo articolo di prodotto

curl

Crea un singolo articolo di prodotto utilizzando il 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 riesce, viene restituito l'oggetto 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

public static Product createProduct(Product productToCreate, String productId)
    throws IOException {
  return getProductServiceClient().createProduct(
      DEFAULT_BRANCH_NAME, productToCreate, productId
  );
}

Aggiorna le informazioni sui prodotti

Man mano che il catalogo dei prodotti cambia, puoi aggiornarlo caricando in tempo reale le modifiche ai prodotti, come 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 sui prodotti utilizzando il products.patch metodo.

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 riesce, viene restituito l'oggetto 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

public static Product updateProduct(Product productToUpdate) throws IOException {
  return getProductServiceClient().updateProduct(productToUpdate, FieldMask.getDefaultInstance());
}

Elimina le informazioni sui prodotti

Sebbene l'API fornisca un modo per eliminare i prodotti dal catalogo, tieni presente che se registri un evento utente relativo a un articolo di prodotto 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 consigli.

Dovresti impostare la availability dei prodotti obsoleti su OUT_OF_STOCK anziché eliminarli.

curl

Elimina un prodotto utilizzando il delete metodo, 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

public static void deleteProduct(String productName) throws IOException {
  getProductServiceClient().deleteProduct(productName);
}

Recupera un articolo di prodotto

curl

Per recuperare un articolo di prodotto, invia una GET richiesta 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

public static Product getProduct(String productName) throws IOException {
  return getProductServiceClient().getProduct(productName);
}

Visualizza le informazioni aggregate sul catalogo

Puoi visualizzare le informazioni aggregate sul catalogo e visualizzare l'anteprima dei prodotti caricati nella scheda Catalogo della pagina Dati di AI Commerce Search in Gemini Enterprise for Customer Experience console.

Valuta la qualità dei dati del catalogo

Per valutare la qualità dei dati del catalogo:

Vai alla pagina Qualità dei dati di AI Commerce Search in Gemini Enterprise for Customer Experience console.

Vai alla pagina Qualità dei dati

La pagina Qualità dei dati valuta se devi aggiornare i dati del catalogo per migliorare la qualità dei risultati di ricerca e sbloccare i livelli di rendimento 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 rendimento della ricerca.

Per un riepilogo delle metriche del catalogo disponibili, consulta Metriche di qualità del catalogo.

Modifica i tipi di prodotto

Quando importi un prodotto, puoi specificare se il tipo di prodotto è primario, variante o raccolta. 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 ulteriori dettagli, consulta product.Type nella documentazione di riferimento.

Modifica la configurazione a livello di prodotto

Per importare un catalogo con Merchant Center, devi specificare se i prodotti sono primari o varianti.

Se i livelli di prodotto cambiano o sono stati specificati in modo errato, utilizza questa procedura per correggere la configurazione. Per completare questa procedura, devi disporre del ruolo IAM Amministratore Retail.

Assicurati che non siano in corso importazioni durante la riconfigurazione dei livelli di prodotto. In questo modo, i dati non vengono caricati al livello errato.
Elimina tutti gli articoli di prodotto. Consulta products.delete. Prima di procedere al passaggio successivo, il catalogo deve essere completamente vuoto.
Reimporta i dati per modificare la configurazione a livello di prodotto.

Questa procedura dipende dalla modalità di importazione. Segui la procedura appropriata in Importare le informazioni del catalogo per impostare i livelli di prodotto su la nuova configurazione.
Completa l'importazione del nuovo catalogo con la configurazione del livello modificata, utilizzando la procedura scelta in Importare le 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.

Vai alla pagina Modelli

Per i dettagli sui costi di ottimizzazione, consulta Prezzi.

Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.

Ultimo aggiornamento 2026-05-08 UTC.