En esta documentación de Recomendaciones IA, se hace referencia a la consola de Recomendaciones. Le recomendamos que cambie a la consola de venta minorista y utilice la documentación de venta minorista, que documenta Recomendaciones IA, la consola de venta minorista y Retail Search.

Si usas la versión v1beta de Recomendaciones IA, migra a la versión minorista de la API.

Administrar 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 Recomendaciones IA. 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.

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": "Shoes & Accessories > Shoes"
    }' \
    "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": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "product title",
  "availability": "IN_STOCK"
}

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",
       "categories": "Shoes & Accessories > Shoes"
    }" \
    "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": [
    "Shoes & Accessories \u003e Shoes"
  ],
  "title": "new product title",
  "availability": "IN_STOCK"
}

Borra información del producto

Aunque Recomendaciones IA 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ó, Recomendaciones IA 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 el rendimiento de la predicción.

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 elemento 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]"

Recupera un elemento de producto

curl

Para recuperar un elemento de producto, 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": [
      "Shoes & Accessories \u003e Shoes"
    ],
    "title": "product title",
    "availability": "IN_STOCK"
}

Visualiza 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 elementos de producto subidos en la pestaña Catálogo en la página Datos de Recomendaciones IA.

Datos de importación de catálogos de Recomendaciones IA

Cambia la configuración a nivel de producto

Cuando importes un catálogo, debes especificar si los elementos del catálogo 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 de Administrador de Recomendaciones IA.

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

  2. Si planeas cambiar los niveles de elementos del catálogo de eventos, borra definitivamente todos los eventos de usuario mediante el método de eliminación definitiva.

  3. Borra todos los elementos de productos. Consulta Cómo borrar elementos de productos. El catálogo debe estar completamente vacío antes de continuar con el siguiente paso.

  4. Cambia 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 del catálogo en su configuración nueva.

  5. 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.

  6. 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.

    Ir a la página Modelos de Recomendaciones IA

    Para ajustar los detalles de los costos, consulta Precios.