Gestire le informazioni del catalogo

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

Per mantenere aggiornato il catalogo in base alle modifiche delle informazioni sui prodotti, importalo come la prima volta. Per assistenza sull'importazione del catalogo, consulta Importare le informazioni del catalogo.

Tutorial per creare/ottenere/aggiornare/eliminare un prodotto

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

  • Creare un prodotto
  • Ottieni un prodotto
  • Aggiornare 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

Tutorial sulla creazione di un 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

Tutorial per ottenere un prodotto

Questo tutorial mostra come recuperare un articolo del prodotto.

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

Procedura guidata

Tutorial sull'aggiornamento del 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

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

Procedura guidata

Caricare un prodotto

curl

Crea un singolo articolo utilizzando il metodo REST products.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 va a buon fine, 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
  );
}

Aggiornare le informazioni sul prodotto

Man mano che il tuo catalogo dei prodotti cambia, puoi aggiornarlo caricando in tempo reale le modifiche ai prodotti, ad esempio nuovi prodotti, prezzi e stato di disponibilità. 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 metodo products.patch.

Il seguente esempio 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 va a buon fine, 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());
}

Eliminare le informazioni sul prodotto

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

Devi impostare il 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

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

Recuperare un articolo del prodotto

curl

Per recuperare un articolo del prodotto, invia 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

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

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 Ricerca per la vendita al dettaglio.

Valutare la qualità dei dati del catalogo

Per valutare la qualità dei dati del tuo catalogo:

  1. Vai alla pagina Qualità dei dati nella console Ricerca per la vendita al dettaglio.

    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 nella ricerca.

Per scoprire di più su come controllare la qualità dei dati di ricerca e visualizzare i livelli di rendimento della ricerca, consulta Ottenere i livelli di rendimento della ricerca.

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

Modificare i tipi di prodotto

Quando importi un prodotto, puoi specificare se il tipo è principale, variabile o una collezione. Se il tipo di un prodotto cambia o è stato specificato scorrettamente, devi eliminare il prodotto e crearlo con il tipo aggiornato specificato.

Il tipo di un prodotto può essere impostato su TYPE_UNSPECIFIED, PRIMARY, VARIANT o COLLECTION. Per ulteriori 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 principali o varianti. Se questi livelli di prodotto cambiano o sono stati specificati in modo errato, utilizza la procedura riportata di seguito per correggere la loro configurazione. Per completare questa procedura, devi disporre del ruolo IAM Amministratore vendita al dettaglio.

  1. Assicurati che non siano in corso importazioni durante la riconfigurazione dei livelli di prodotto. In questo modo, i dati non vengono caricati al livello sbagliato.

  2. Elimina tutti gli articoli del prodotto. Consulta products.delete. Il catalogo deve essere completamente vuoto prima di procedere al passaggio successivo.

  3. 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 Importare le informazioni del catalogo per impostare i livelli di prodotto sulla nuova configurazione.

  4. Completa l'importazione del nuovo catalogo con la configurazione del livello modificata utilizzando la procedura scelta in Importare le informazioni del catalogo.

  5. Ottimizza tutti i modelli esistenti.

    Per ottimizzare un modello, vai alla pagina Modelli, fai clic sul nome del modello per visualizzare la relativa pagina dei dettagli e poi fai clic su Ottimizzazione manuale nella barra dei pulsanti.

    Vai alla pagina Modelli

    Per i dettagli sui costi di ottimizzazione, consulta la pagina Prezzi.