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.
- Documentación práctica de la API de venta minorista
- Documentación de referencia de la API de venta minorista
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:
- Documentación práctica de la API del Motor de recomendaciones
- Documentación de referencia de la API del Motor de recomendaciones
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 nombresautomlrecommendations
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étodopredict
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.
Cuando importes datos de catálogos desde BigQuery, usa el esquema para la venta minorista: Esquema para catálogos de la venta minorista.
Cuando registres datos de eventos de usuario, usa el esquema adecuado para cada evento: Esquemas para eventos de la venta minorista.