Faça a gestão das informações do catálogo

Esta página descreve como gerir as informações dos produtos depois de ter importado um catálogo para o Vertex AI Search for commerce. Pode ler, escrever e eliminar produtos no seu catálogo.

Para manter o catálogo atualizado à medida que as informações dos produtos mudam, importe o catálogo da mesma forma que o fez pela primeira vez. Para obter ajuda com a importação do seu catálogo, consulte o artigo Importar informações do catálogo.

Crie, aceda e faça a gestão de tutoriais de produtos

Este tutorial mostra como usar os métodos da API, que realizam as seguintes ações:

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Criar produto

Este tutorial mostra como criar um único produto.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Get product

Este tutorial mostra como obter um artigo do produto.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Atualize o produto

Este tutorial mostra como atualizar um produto num catálogo.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Eliminar produto

Este tutorial mostra-lhe como eliminar um produto de um catálogo.

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

Carregue um único item de produto

curl

Crie um único artigo do produto através do método 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 o pedido for bem-sucedido, o objeto product é devolvido, como no exemplo seguinte.

{
  "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
  );
}

Atualize as informações sobre os produtos

À medida que o catálogo de produtos muda, pode atualizá-lo carregando alterações nos produtos, como novos produtos, preços e estado do stock em tempo real. Pode carregar apenas os produtos que foram adicionados ou alterados. Não precisa de recarregar todo o catálogo.

curl

Atualize as informações sobre os produtos através do método products.patch.

O exemplo seguinte atualiza o título de um produto específico:

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 o pedido for bem-sucedido, o objeto product é devolvido, como no exemplo seguinte.

{
  "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());
}

Elimine informações sobre o produto

Embora a API ofereça uma forma de eliminar produtos do seu catálogo, tenha em atenção que, se registar um evento do utilizador relacionado com um artigo do produto que foi eliminado, a API não pode processar o evento do utilizador corretamente e este pode ser eliminado. Além disso, a inclusão de dados do catálogo históricos melhora a qualidade do seu modelo e é fundamental para boas recomendações e resultados da pesquisa.

Deve definir o availability dos produtos obsoletos como OUT_OF_STOCK em vez de os eliminar.

curl

Elimine um produto através do método delete, substituindo PRODUCT_ID pelo ID do produto que quer eliminar.

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);
}

Obtenha um artigo do produto

curl

Pode obter um artigo do produto fazendo um pedido GET ao ponto final products, substituindo PRODUCT_ID pelo ID do produto que quer obter:

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"

Deverá ver uma saída semelhante à seguinte:

{
    "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);
}

Veja informações agregadas sobre o seu catálogo

Pode ver informações agregadas sobre o seu catálogo e pré-visualizar os produtos carregados no separador Catálogo na página Dados da consola do Search for commerce.

Avalie a qualidade dos dados do catálogo

Para avaliar a qualidade dos dados do catálogo:

  1. Aceda à página Qualidade dos dados na consola de pesquisa para comércio.

    Aceda à página Qualidade de dados

    A página Qualidade dos dados avalia se tem de atualizar os dados do catálogo para melhorar a qualidade dos resultados da pesquisa e desbloquear os níveis de desempenho da pesquisa.

Para saber como verificar a qualidade dos dados de pesquisa e ver os níveis de desempenho da pesquisa, consulte o artigo Desbloqueie os níveis de desempenho da pesquisa.

Para ver um resumo das métricas do catálogo disponíveis, consulte o artigo Métricas de qualidade do catálogo.

Altere os tipos de produtos

Quando importa um produto, pode especificar se o tipo do produto é principal, variante ou uma coleção. Se o tipo de um produto mudar ou tiver sido especificado incorretamente, tem de eliminar o produto e criá-lo com o tipo atualizado especificado.

O tipo de um produto pode ser definido como TYPE_UNSPECIFIED, PRIMARY, VARIANT ou COLLECTION. Para mais detalhes, consulte product.Type na documentação de referência.

Altere a configuração ao nível do produto

Para importar um catálogo com o Merchant Center, tem de especificar se os produtos são principais ou variantes.

Se os níveis de produtos mudarem ou tiverem sido especificados incorretamente, use este procedimento para corrigir a respetiva configuração. Tem de ter a função do IAM de administrador de retalho para concluir este procedimento.

  1. Certifique-se de que não estão a ocorrer importações enquanto reconfigura os níveis dos produtos. Isto verifica se os dados não são carregados ao nível errado.

  2. Elimine todos os itens de produtos. Consulte products.delete. O catálogo tem de estar completamente vazio antes de avançar para o passo seguinte.

  3. Reimporte os dados para alterar a configuração ao nível do produto.

    Este procedimento depende da forma como importa. Siga o procedimento adequado em Importar informações do catálogo para definir os níveis dos produtos para a respetiva nova configuração.

  4. Conclua a importação do novo catálogo com a configuração de nível modificada, usando o procedimento escolhido em Importar informações do catálogo.

  5. Ajustar todos os modelos existentes.

    Para otimizar um modelo, aceda à página Modelos, clique no nome do modelo para ver a respetiva página de detalhes e, de seguida, clique em Otimização manual na barra de botões.

    Aceda à página Modelos

    Para ver detalhes dos custos de otimização, consulte a secção Preços.