Questa è la documentazione di Recommendations AI, Retail Search e la nuova console di Retail.

Gestire le informazioni del catalogo

Questa pagina descrive come gestire le informazioni sui prodotti dopo aver importato un catalogo nell'API Retail. Puoi leggere, scrivere ed eliminare i prodotti nel tuo catalogo.

Per mantenere il catalogo aggiornato ogni volta che le informazioni sui prodotti cambiano, importa il catalogo allo stesso modo della prima volta. Per informazioni sull'importazione del catalogo, vedi Importazione delle informazioni sul catalogo.

Tutorial per creare/ottenere/aggiornare/eliminare un prodotto

Questo tutorial illustra come utilizzare i metodi del servizio del prodotto API Retail, che eseguono le seguenti azioni:

  • Creare un prodotto
  • Ottieni un prodotto
  • Aggiorna un prodotto
  • Elimina un prodotto

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

Procedura guidata


Nelle sezioni seguenti puoi seguire la stessa procedura utilizzata per fare clic su Procedura guidata.

Tutorial sulla creazione di un prodotto

Questo tutorial illustra come creare un singolo prodotto.


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

Procedura guidata


Nelle sezioni seguenti puoi seguire la stessa procedura utilizzata per fare clic su Procedura guidata.

Tutorial per ottenere un prodotto

Questo tutorial ti mostra come recuperare un articolo del prodotto.


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

Procedura guidata


Nelle sezioni seguenti puoi seguire la stessa procedura utilizzata per fare clic su Procedura guidata.

Tutorial sull'aggiornamento del prodotto

Questo tutorial illustra come aggiornare un prodotto in un catalogo.


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

Procedura guidata


Nelle sezioni seguenti puoi seguire la stessa procedura utilizzata per fare clic su Procedura guidata.

Tutorial sull'eliminazione di un prodotto

Questo tutorial mostra come eliminare un prodotto da un catalogo.


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

Procedura guidata


Nelle sezioni seguenti puoi seguire la stessa procedura utilizzata per fare clic su Procedura guidata.

Carica un prodotto

Curling

Crea un singolo prodotto 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": "Shoes & Accessories > Shoes"
    }' \
    "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 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": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "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 sul prodotto

Man mano che il catalogo dei prodotti cambia, puoi aggiornare il catalogo caricando modifiche in tempo reale su prodotti come nuovi prodotti, prezzi e stato delle scorte. Puoi caricare solo i prodotti aggiunti o modificati; non devi ricaricare l'intero catalogo.

Curling

Aggiorna le informazioni sul prodotto utilizzando il metodo products.patch.

L'esempio seguente aggiorna il titolo per 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 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": [
    "Shoes & Accessories > Shoes"
  ],
  "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 Retail offra un modo per eliminare i prodotti dal tuo catalogo, tieni presente che se registri un evento utente relativo a un articolo di prodotto che è stato eliminato, l'API Retail non può elaborare correttamente l'evento utente e potrebbe essere eliminato. Inoltre, l'inclusione dei dati storici del catalogo migliora la qualità del tuo modello ed è fondamentale per ottenere buoni consigli e risultati di ricerca.

Dovresti impostare l'attributo availability dei prodotti obsoleti su OUT_OF_STOCK anziché eliminarlo.

Curling

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

Curling

Recupera un articolo di prodotto inviando 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": [
      "Shoes & Accessories \u003e Shoes"
    ],
    "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 le informazioni aggregate sul tuo catalogo e visualizzare l'anteprima degli articoli caricati nella scheda Catalogo della pagina Dati di vendita al dettaglio.

Modificare i tipi di prodotti

Quando importi un prodotto, puoi specificare se il tipo di prodotto è principale, 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.

È possibile impostare un tipo di prodotto 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 primari o varianti. Se i livelli di prodotto cambiano o sono stati specificati in modo errato, segui la procedura riportata di seguito per correggere la configurazione. Per completare questa procedura devi disporre del ruolo IAM Amministratore per la vendita al dettaglio.

  1. Assicurati che non vengano eseguite importazioni mentre riconfiguri i livelli di prodotto. In questo modo i dati non verranno caricati al livello sbagliato.

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

  3. Reimporta i dati per modificare la configurazione a livello di prodotto.

    Questa procedura dipende dalla modalità di importazione. Segui la procedura appropriata in Importa informazioni catalogo per impostare i livelli di prodotto sulla nuova configurazione.

  4. Completa l'importazione del nuovo catalogo con la configurazione del livello modificato utilizzando la procedura che hai scelto in Importa informazioni catalogo.

  5. Perfezionare 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, quindi fai clic su Ottimizzazione manuale nella barra dei pulsanti.

    Vai alla pagina Modelli di vendita al dettaglio

    Per informazioni dettagliate sul costo, consulta la sezione Prezzi.