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.
Read a User's Metadata
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")
User metadata options vary depending on which provider you're using and which metadata fields you enable.
Advertencia
User Metadata May Be Stale
Atlas App Services fetches the most recent version of user metadata when a user logs in. If the user changes their email address or profile photo with a login provider, for example, those changes do not update in user metadata until the user logs in again. Because we cache credentials and enable you to bypass the login flow, user metadata may become stale unless you force the user to log in again.
Serializable User Metadata
Nueva en la versión 1.9.0.
Kotlin SDK version 1.9.0 introduced an API that supports:
Un codificador EJSON limitado pero estable para los metadatos del usuario retornada por
User.profileAsBsonDocument()Un codificador EJSON experimental que admite la serialización completa de documentos para los metadatos del usuario retornados por la Función usuario. perfil() método de extensión. Este codificador y método requieren una suscripció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
You can only read user metadata from the client app that you have configured on the App Services application.
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.
Update User Metadata
User metadata that you access through the authentication provider is read-only data. You cannot update or edit user metadata that comes from this source.
If you would like to give a user the option the update their metadata from within your client app, use custom user data, instead.