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

Ahora Recomendaciones IA usa la API de venta minorista. En esta página, se explican los cambios ingresados y las prácticas recomendadas de migración para la migración de la versión v1beta1 de la API del Motor de recomendaciones (extremo de servicio https://recommendationengine.googleapis.com) a la API de venta minorista (extremo de servicio https://retail.googleapis.com) de disponibilidad general.

La API del Motor de recomendaciones y su conjunto de documentaciones permanecerán disponibles, pero ya no se actualizarán.

Este documento te será útil únicamente 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 la migración completa.
  • La migración de tráfico incremental es mejor que realizar una sola transición completa. Si es posible, migra de forma gradual tu tráfico de v1beta1 a v2.
  • Si ejecutas servicios en diferentes regiones, es mejor migrar regiones de a una para evitar que se produzca una interrupción global.

Cambios en la documentación

Este conjunto de documentaciones es para la API de venta minorista disponible de forma general.

El conjunto de documentaciones Beta de la API del Motor de recomendaciones y su conjunto de documentaciones permanecerán disponibles, pero ya no se actualizarán. Puedes encontrar la documentación de la versión Beta a continuación:

Rutas de acceso de REST y RPC

Se realizaron muchos cambios en las rutas 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.

Por ejemplo:

API del Motor de recomendaciones de v1beta1: 

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

API de venta minorista de v2:

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

Algunos nombres y métodos se renombraron, quitaron o agregaron recientemente. En la siguiente tabla, se comparan los recursos de v1beta1 y v2 y sus métodos asociados en paralelo.

Por ejemplo, el recurso catalogs.catalogItems de v1beta1 es equivalente al recurso catalogs.branches.products de v2. El método list, que estaba disponible en catalogs.catalogItems para la versión v1beta1, no está disponible para catalogs.branches.products en la versión v2, por lo que se indica como Quitado.

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

Recurso de v1beta1 Método Recurso de v2 Método
catalogs list catalogs list
patch patch
N/A catalogs.branches.operations get
catalogs.catalogItems create catalogs.branches.products create
delete delete
get get
import import
list Eliminado
patch patch
catalogs.operations get catalogs.operations get
list list
catalogs.eventStores.operations get Eliminado
list
catalogs.eventStores.placements predict catalogs.placements predict
catalogs.eventStores.predictionApiKeyRegistrations create Eliminado
delete
list
catalogs.eventStores.userEvents collect catalogs.userEvents collect
import import
list Eliminado
purge purge
rejoin rejoin
write write
N/A operations get
list

Cambios en IAM

Los siguientes cambios se implementaron en las funciones y los permisos de la administración de identidades y accesos (IAM) de la venta minorista:

  • La venta minorista usa funciones y permisos de IAM en el espacio de nombres retail, en lugar de en el espacio de nombres automlrecommendations que usaba la versión v1beta1 del Motor de recomendaciones.
  • 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.

Esquema de eventos de usuario y catálogos

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