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.

Migra a la API de venta minorista desde la versión Beta

Ahora Recomendaciones IA utiliza la API de Retail. En esta página, se explican los cambios introducidos y las prácticas recomendadas de migración cuando se migra de la versión v1beta1 de la API de Recommendations Engine (extremo de servicio https://recommendationengine.googleapis.com) a la API de Retail para el público general (extremo de servicio https://retail.googleapis.com).

La API de Motor de recomendaciones y su conjunto de documentación permanecen disponibles, pero ya no se actualizarán.

Este documento se aplica a ti solo si comenzaste a usar Recomendaciones IA cuando estaba en versión Beta.

Prácticas recomendadas

  • Envía tráfico de solo validación antes de realizar una migración completa.
  • Es mejor migrar el tráfico de forma incremental que realizar el cambio de una sola vez. Si es posible, migra de forma gradual tu tráfico de v1beta1 a v2.
  • Si ejecutas servicios en diferentes regiones, es mejor migrar las regiones una por una para evitar interrupciones globales.

Cambios en la documentación

Este conjunto de documentación es solo para Recomendaciones IA y la Consola de recomendaciones. Recomendamos trasladar los proyectos de Recomendaciones IA a la consola de venta minorista más reciente y usar la documentación de venta minorista, que hace referencia a la consola de venta minorista.

La documentación de Retail abarca Recomendaciones IA, la consola de venta minorista y Retail Search:

El conjunto de documentación Beta para la API de Recomendaciones de Engine y su conjunto de documentación seguirán disponibles, pero ya no se actualizarán. Puedes encontrar la documentación Beta a continuación:

Cambios en Console

La consola de Recomendaciones IA reemplaza a la consola de Recomendaciones.

La venta minorista de Cloud Console está disponible de forma pública el 20 de enero de 2022. Si usas la consola de Recomendaciones, te recomendamos acceder a tus proyectos de Recomendaciones IA desde la consola de Retail.

Para obtener una explicación de los cambios de funcionalidad y terminología en la consola de Recomendaciones IA en comparación con la consola de recomendaciones, consulta Cambia a la consola de venta minorista en la documentación de venta minorista.

Configuraciones y posiciones de publicación

La API de Retail presenta configuraciones de entrega, que reemplaza el concepto de posiciones que usa la API de Motor de recomendaciones.

Las configuraciones de entrega están disponibles a partir de las Recomendaciones IA v2 y Retail Search v2alpha, mediante la API de Retail.

Si tienes posiciones existentes o nuevas, la API de Retail creará automáticamente una configuración de entrega asociada con cada una. Si creas una configuración de entrega, no se creará una posición correspondiente.

Si borras una configuración de entrega, se borra su posición correspondiente y, si borras una posición, se borra su configuración de entrega correspondiente.

Las opciones de configuración de publicación te permiten editar las opciones de diversidad y reclasificación de precio, y hacer que se apliquen casi en tiempo real. Con las posiciones, la configuración de la diversidad y los precios solo se puede cambiar desde el modelo de recomendación al que apunta la posición.

Las posiciones aún son compatibles, pero se recomienda usar las configuraciones de publicación.

Para obtener más información sobre el uso de la configuración de entrega, consulta Configuraciones de entrega y Crea configuraciones de entrega en la documentación de venta minorista.

Rutas de acceso de REST y RPC

Se realizaron muchos cambios en las rutas de acceso de REST y RPC. Asegúrate de revisar la documentación de la API de venta minorista para asegurarte de llamar a la API de forma correcta.

Todas las rutas de acceso ahora usan retail.googleapis.com en lugar de recommendationengine.googleapis.com.

como los siguientes:

API de recomendaciones del motor v1beta1: 

GET https://recommendationengine.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

API de v2 Retail:

GET https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/operations/OPERATION_ID

Se cambiaron los nombres de algunos recursos y métodos, se quitaron o se agregaron recientemente. Usa la siguiente tabla para comparar los recursos de v1beta1 con los de v2.

Tenga en cuenta que los vínculos a los recursos de v1beta1 se dirigen a la documentación de la API para v1beta1.

Recurso v1beta1 Método Recurso v2 Método
catalogs list catalogs list
patch patch
No disponible catalogs.branches.operations get
catalogs.catalogItems create catalogs.branches.products create
delete delete
get get
import import
list Quitado
patch patch
catalogs.operations get catalogs.operations get
list list
catalogs.eventStores.operations get Quitado
list
catalogs.eventStores.placements predict catalogs.placements predict
catalogs.eventStores.predictionApiKeyRegistrations create Quitado
delete
list
catalogs.eventStores.userEvents collect catalogs.userEvents collect
import import
list Quitado
purge purge
rejoin rejoin
write write
No disponible operations get
list

Cambios en la IAM

Se introdujeron los siguientes cambios en las funciones y los permisos de la administración de identidades y accesos (IAM) de Recomendaciones IA:

  • Recomendaciones IA utiliza funciones y permisos de IAM en el espacio de nombres retail en lugar del espacio de nombres automlrecommendations que usó Recomendaciones Engine v1beta1.
  • Se quitó la función Admin Viewer.
  • Se quitaron los permisos para apiKeys porque el método predict ya no requiere su propia clave de API.

Esquemas de esquemas de eventos de catálogos y usuarios

Los esquemas de los eventos de catálogo y de usuario cambiaron en la API de venta minorista.