Administra la información del catálogo

En esta página, se describe cómo administrar la información de tu producto después de importar un catálogo a Vertex AI Search para la venta minorista. Puedes leer, escribir y borrar productos en tu catálogo.

Para mantener tu catálogo actualizado a medida que cambia la información del producto, importa el catálogo de la misma manera que la primera vez. Para obtener ayuda con la importación de tu catálogo, consulta Importa información del catálogo.

Instructivo para crear, obtener, actualizar o borrar productos

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

  • Crea un producto
  • Obtén un producto
  • Actualiza un producto
  • Borrar un producto

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Instructivo para crear un producto

En este instructivo, se muestra cómo crear un solo producto.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Instructivo para obtener un producto

En este instructivo, se muestra cómo recuperar un artículo de producto.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Instructivo para actualizar productos

En este instructivo, se muestra cómo actualizar un producto en un catálogo.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Instructivo para borrar un producto

En este instructivo, se muestra cómo borrar un producto de un catálogo.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Sube un producto

curl

Crea un elemento de producto único 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 muestra el objeto del 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
  );
}

Actualiza la información de los productos

A medida que tu catálogo de productos cambia, puedes actualizarlo para subir cambios en productos como productos nuevos, precios y el estado de las acciones en tiempo real. Solo puedes subir productos que se hayan agregado o modificado. No es necesario volver a cargar todo el catálogo.

curl

Actualiza la información del producto mediante el método products.patch.

En el siguiente ejemplo, se actualiza el título de un producto 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"

Si la solicitud se realiza correctamente, se muestra el objeto del 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());
}

Cómo borrar información del producto

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

Debes establecer el availability de los productos obsoletos en OUT_OF_STOCK en lugar de borrarlos.

curl

Para borrar un producto, usa el método delete y reemplaza PRODUCT_ID por el ID del producto que deseas borrar.

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

Cómo recuperar un elemento de producto

curl

Para recuperar un elemento de elemento, realiza una solicitud GET al extremo products y reemplaza PRODUCT_ID por el ID del producto que deseas 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"

Debería ver un resultado similar al 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);
}

Consulta la información agregada sobre tu catálogo

Puedes ver la información agregada sobre tu 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 Retail.

Evalúa la calidad de los datos del catálogo

Para evaluar la calidad de tus datos de catálogo, sigue estos pasos:

  1. Ve a la página Calidad de los datos en la consola de Search for Retail.

    Ir a la página Calidad de los datos

    En la página Calidad de los datos, se evalúa si necesitas actualizar los datos del catálogo para mejorar la calidad de los resultados de la búsqueda y desbloquear los niveles de rendimiento de la búsqueda.

Para obtener más información sobre cómo verificar la calidad de los datos de búsqueda y ver los niveles de rendimiento de la búsqueda, consulta Cómo desbloquear los niveles de rendimiento de la búsqueda.

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

Cambia los tipos de productos

Cuando importas un producto, puedes especificar si el tipo del producto es principal, variante o una colección. Si el tipo de un producto cambia o se especificó de forma incorrecta, debes borrarlo y crearlo con el tipo actualizado especificado.

El tipo de producto se puede configurar como TYPE_UNSPECIFIED, PRIMARY, VARIANT o COLLECTION. Para obtener más detalles, consulta product.Type en la documentación de referencia.

Cambia la configuración a nivel del producto

Cuando importes un catálogo con Merchant Center, debes especificar si los productos son primarios o variantes. Si estos niveles de producto cambian o se especificaron de forma incorrecta, usa el siguiente procedimiento para corregir su configuración. Debes tener la función de IAM Administrador de venta minorista para completar este procedimiento.

  1. Asegúrate de que no se realicen importaciones mientras vuelves a configurar los niveles de producto. Esto garantiza que los datos no se suban en el nivel incorrecto.

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

  3. Vuelve a importar tus datos para cambiar la configuración a nivel del producto.

    Este procedimiento depende de cómo importes. Sigue el procedimiento adecuado en Importa información del catálogo para establecer los niveles de producto en su nueva configuración.

  4. Termina de importar el catálogo nuevo con la configuración del nivel modificada mediante el procedimiento que elegiste en Importa información del catálogo.

  5. Ajusta todos los modelos existentes.

    Para ajustar un modelo, ve a la página Modelos, haz clic en el nombre del modelo para ver su página de detalles y, luego, en Ajuste manual en la barra de botones.

    Ve a la página Modelos

    Para ajustar los detalles de los costos, consulta Precios.