Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Retail.

Gerenciar informações de catálogo

Nesta página, você verá como gerenciar as informações do produto depois de importar um catálogo para a API Retail. É possível ler, gravar e excluir produtos no seu catálogo.

Para manter seu catálogo atualizado conforme as informações do produto são alteradas, importe seu catálogo da mesma forma que na primeira vez. Para receber ajuda sobre como importar seu catálogo, consulte Como importar informações de catálogo.

Tutorial de criação, recebimento, atualização e exclusão de produtos

Neste tutorial, mostramos como usar os métodos do serviço de produto da API Retail, que realizam as seguintes ações:

  • Criar um produto.
  • Receber um produto
  • Atualizar um produto
  • Excluir um produto

Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientação


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Tutorial de criação de produtos

Neste tutorial, mostramos como criar um único produto.


Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientação


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Tutorial de recebimento de produtos

Neste tutorial, mostramos como recuperar um item de produto.


Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientação


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Tutorial de atualização de produtos

Neste tutorial, mostramos como atualizar um produto em um catálogo.


Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientação


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Tutorial de exclusão de produtos

Neste tutorial, mostramos como excluir um produto de um catálogo.


Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientação


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Fazer upload de um produto

curl

Crie um único item de produto usando o 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": "Shoes & Accessories > Shoes"
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/branches/0/products?productID=PRODUCT_ID"

Se a solicitação for bem-sucedida, o objeto do produto será retornado, como no exemplo a seguir.

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

Atualize as informações do produto

É possível atualizar seu catálogo fazendo upload de alterações em produtos como novos produtos, preços e status de estoque em tempo real, conforme seu produto muda. Somente é possível fazer upload de produtos adicionados ou alterados: não é necessário atualizar todo o catálogo.

curl

Atualize as informações do produto usando o método products.patch.

O exemplo a seguir 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 a solicitação for bem-sucedida, o objeto do produto será retornado, como no exemplo a seguir.

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

Excluir informações do produto

Ainda que a API Retail ofereça uma maneira de excluir produtos do catálogo, lembre-se de que, se você registrar um evento de usuário relacionado a um item de produto que foi excluído, a API Retail não poderá processar o evento do usuário corretamente e ele pode ser excluído. Além disso, incluir dados históricos de catálogo melhora a qualidade do modelo e é fundamental para boas recomendações e resultados da pesquisa.

Defina o availability de produtos obsoletos como OUT_OF_STOCK em vez de excluí-los.

curl

Exclua um produto usando o método delete, substituindo PRODUCT_ID pelo ID do produto que você quer excluir.

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

Recuperar um item do produto

curl

Para recuperar um item do produto, faça uma solicitação GET para o endpoint products, substituindo PRODUCT_ID pelo ID do produto que você quer recuperar:

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"

O resultado será semelhante a:

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

Ver informações agregadas sobre o catálogo

Veja informações agregadas sobre seu catálogo e visualize itens de produtos enviados na guia "Catálogo" na página Dados de varejo.

Alterar tipos de produto

Ao importar um produto, é possível especificar se o tipo do produto é principal, variante ou uma coleção. Se o tipo de um produto mudar ou tiver sido especificado incorretamente, será necessário excluir o produto e criá-lo com o tipo atualizado especificado.

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

Alterar configuração no nível do produto

Ao importar um catálogo com o Merchant Center, é necessário especificar se os produtos são principais ou variantes. Se esses níveis do produto mudarem ou forem especificados incorretamente, use o procedimento abaixo para corrigir a configuração deles. É necessário ter o papel do IAM de administrador de varejo para concluir este procedimento.

  1. Verifique se nenhuma importação está ocorrendo enquanto você reconfigura os níveis do produto. Isso garante que os dados não sejam enviados no nível errado.

  2. Exclua todos os itens do produto. Veja products.delete. O catálogo precisa estar completamente vazio antes de passar para a próxima etapa.

  3. Importe novamente seus dados para alterar a configuração no nível do produto.

    Este procedimento depende da sua importação. Siga o procedimento apropriado em Importar informações do catálogo para definir os níveis de produto como a 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. Ajuste todos os modelos existentes.

    Para ajustar um modelo, acesse a página "Modelos": clique no nome do modelo para ver a respectiva página de detalhes e, em seguida, clique em Ajuste manual na barra de botões.

    Acessar a página "Modelos de varejo"

    Para ajustar os detalhes de custo, consulte Preços.