Gestionar información de catálogos

En esta página se describe cómo gestionar la información de sus productos después de haber importado un catálogo en Vertex AI Search para el sector del comercio. Puedes leer, escribir y eliminar productos de tu catálogo.

Para mantener su catálogo actualizado a medida que cambia la información de los productos, impórtelo de la misma forma que la primera vez. Para obtener ayuda con la importación de tu catálogo, consulta Importar la información de catálogos.

Crear, acceder y gestionar tutoriales de productos

En este tutorial se muestra cómo usar los métodos de la API, que realizan las siguientes acciones:

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Crear producto

En este tutorial se explica cómo crear un solo producto.

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Get product

En este tutorial se explica cómo obtener un artículo de producto.

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Actualizar producto

En este tutorial se explica cómo actualizar un producto de un catálogo.

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Eliminar producto

En este tutorial se explica cómo eliminar un producto de un catálogo.

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Subir un solo producto

curl

Crea un solo elemento de producto con el 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"

Si la solicitud se realiza correctamente, se devuelve el objeto de producto, como en el siguiente ejemplo.

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

Actualizar la información de los productos

A medida que cambie su catálogo de productos, podrá actualizarlo subiendo los cambios en los productos, como los nuevos productos, los precios y el estado del stock, en tiempo real. Solo puede subir los productos que se hayan añadido o modificado. No es necesario que vuelva a cargar todo el catálogo.

curl

Actualice la información de los productos con el método products.patch.

En el siguiente ejemplo se actualiza el título de un producto concreto:

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"

Si la solicitud se realiza correctamente, se devuelve el objeto de producto, como en el siguiente ejemplo.

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

Eliminar información del producto

Aunque la API proporciona una forma de eliminar productos de tu catálogo, ten en cuenta que, si registras un evento de usuario relacionado con un producto que se ha eliminado, la API no podrá procesar el evento de usuario correctamente y podría eliminarse. Además, incluir datos históricos del catálogo mejora la calidad del modelo y es fundamental para obtener buenas recomendaciones y resultados de búsqueda.

Debe definir el availability de los productos obsoletos como OUT_OF_STOCK en lugar de eliminarlos.

curl

Para eliminar un producto, usa el método delete y sustituye PRODUCT_ID por el ID del producto que quieras 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);
}

Recuperar un elemento de producto

curl

Para obtener un artículo de producto, debe enviar una solicitud GET al endpoint products y sustituir PRODUCT_ID por el ID del producto que quiera obtener:

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"

Debería aparecer lo siguiente:

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

Ver información agregada sobre tu catálogo

Puede ver información agregada sobre su catálogo y obtener una vista previa de los productos subidos en la pestaña Catálogo de la página Datos de la consola de Search for Commerce.

Evaluar la calidad de los datos de catálogo

Para evaluar la calidad de los datos de su catálogo, siga estos pasos:

  1. Vaya a la página Calidad de los datos de la consola de búsqueda de comercio.

    Ir a la página Calidad de los datos

    La página Calidad de los datos evalúa si debe actualizar los datos del catálogo para mejorar la calidad de los resultados de búsqueda y acceder a los niveles de rendimiento de búsqueda.

Para obtener más información sobre cómo comprobar la calidad de los datos de búsqueda y ver los niveles de rendimiento de búsqueda, consulta el artículo Desbloquear niveles de rendimiento de búsqueda.

Para ver un resumen de las métricas de catálogo disponibles, consulta Métricas de calidad del catálogo.

Cambiar tipos de producto

Al importar un producto, puede especificar si su tipo es principal, variante o colección. Si el tipo de un producto cambia o se ha especificado incorrectamente, debe eliminar el producto y crearlo de nuevo con el tipo actualizado.

El tipo de un producto puede ser TYPE_UNSPECIFIED, PRIMARY, VARIANT o COLLECTION. Para obtener más información, consulta product.Type en la documentación de referencia.

Cambiar la configuración a nivel de producto

Para importar un catálogo con Merchant Center, debe especificar si los productos son principales o variantes.

Si los niveles de producto cambian o se han especificado de forma incorrecta, siga este procedimiento para corregir su configuración. Para completar este procedimiento, debes tener el rol de IAM Administrador de comercios.

  1. Asegúrate de que no se produzcan importaciones mientras vuelves a configurar los niveles de producto. De esta forma, se verifica que los datos no se suban al nivel incorrecto.

  2. Elimina todos los elementos de producto. Consulta products.delete. El catálogo debe estar completamente vacío antes de continuar con el siguiente paso.

  3. Vuelva a importar los datos para cambiar la configuración a nivel de producto.

    Este procedimiento depende de cómo realices la importación. Sigue el procedimiento adecuado en Importar información del catálogo para definir los niveles de producto en su nueva configuración.

  4. Termine de importar el nuevo catálogo con la configuración de nivel modificada siguiendo el procedimiento que haya elegido en Importar información de catálogos.

  5. Ajusta todos los modelos que ya tengas.

    Para ajustar un modelo, vaya a la página Modelos, haga clic en el nombre del modelo para ver su página de detalles y, a continuación, haga clic en Ajuste manual en la barra de botones.

    Ir a la página Modelos

    Para obtener información detallada sobre los costes de ajuste, consulta la página Precios.