Esta página describe cómo administrar los metadatos de usuario para un usuario autorizado de App Services mediante el SDK de Kotlin de Realm. Para obtener más información, consulte Metadatos del proveedor de autenticación en la documentación de App Services.
Atlas App Services puede leer metadatos de usuario de proveedores de autenticación. Luego, App Services expone los datos de cada usuario en un campo de su... User objeto. Por ejemplo, podría querer acceder al nombre, correo electrónico, fecha de nacimiento o género de un usuario.
Leer los metadatos de un usuario
Puede leer los metadatos de un usuario conectado mediante su objeto "Usuario". No puede editarlos mediante un User objeto.
Para leer los datos, llame al método profileAsBsonDocument en el User objeto de un usuario que haya iniciado sesión:
// Log in a user val user = app.login(Credentials.emailPassword(email, password)) // Access the user's metadata val userEmail = user.profileAsBsonDocument()["email"] Log.i("The logged-in user's email is: $userEmail")
Las opciones de metadatos del usuario varían según el proveedor que utilice y los campos de metadatos que habilite.
Advertencia
Los metadatos del usuario pueden estar obsoletos
Atlas App Services obtiene la versión más reciente de los metadatos del usuario cuando este inicia sesión. Si, por ejemplo, el usuario cambia su dirección de correo electrónico o foto de perfil con un proveedor de inicio de sesión, estos cambios no se actualizan en los metadatos hasta que el usuario vuelve a iniciar sesión. Dado que almacenamos las credenciales en caché y le permitimos omitir el proceso de inicio de sesión, los metadatos del usuario pueden quedar obsoletos a menos que lo obligue a iniciar sesión de nuevo.
Serializable User Metadata
Nuevo en la versión 1.9.0.
La versión 1.9.0 del SDK de Kotlin introdujo una API que admite:
Un codificador EJSON limitado pero estable para metadatos de usuario devueltos por
User.profileAsBsonDocument()Un codificador EJSON experimental que admite la serialización completa de documentos para los metadatos de usuario devueltos por el método de extensión User.profile(). Este codificador y método requieren la activación experimental.
Debes agregar la serialización oficial de KotlinAñade la biblioteca a tu proyecto para usar la serialización EJSON del SDK de Kotlin de Realm. Para más información, consulta Serialización.
Configurar metadatos del usuario
Solo puedes leer metadatos de usuario desde la aplicación cliente que hayas configurado en la aplicación App Services.
Puede configurar los metadatos de usuario que solicita a un proveedor de autenticación. Esto se hace directamente en la configuración del proveedor. Para obtener más información sobre los campos de metadatos que puede usar, consulte los detalles del proveedor:
Puede cambiar qué campos de metadatos ha configurado editando la configuración del proveedor.
Actualizar metadatos del usuario
Los metadatos de usuario a los que accede a través del proveedor de autenticación son de solo lectura. No puede actualizar ni editar los metadatos de usuario que provienen de esta fuente.
Si desea brindarle a un usuario la opción de actualizar sus metadatos desde su aplicación cliente, utilice datos de usuario personalizados en su lugar.