Un'istanza della classe
User
rappresenta un utente. Le istanze utente sono
uniche e comparabili. Se due istanze sono uguali, rappresentano lo stesso utente.
L'applicazione può accedere all'istanza utente per l'utente corrente chiamando la funzione
users.get_current_user()
.
Puoi utilizzare la funzione
users.get_current_user()
indipendentemente dall'opzione di autenticazione
utilizzata dalla tua app.
Un'istanza User può essere creata anche da un indirizzo email:
user = users.User("Albert.Johnson@example.com")
In alternativa, se hai un federated_identity, puoi utilizzarlo per creare un'istanza User:
user = users.User(federated_identity="http://example.com/id/ajohnson")
Se il costruttore utente viene chiamato con un indirizzo email che non corrisponde a un Account Google valido, l'oggetto verrà creato, ma non corrisponderà a un Account Google reale. Ciò avverrà anche se qualcuno crea un Account Google con l'indirizzo email specificato dopo l'archiviazione dell'oggetto. Un valore Utente con un indirizzo email che non rappresenta un Account Google al momento della creazione non corrisponderà mai a un valore Utente che rappresenta un utente reale.
Quando viene eseguito sul server web di sviluppo, si presume che tutti gli oggetti User rappresentino account Google validi quando vengono archiviati nel datastore (simulato).
L'oggetto User per un utente valido può fornire un valore ID univoco per l'utente che
rimane invariato anche se l'utente cambia il proprio indirizzo email. Il metodo
user_id()
restituisce questo ID, un valore
str
.
L'oggetto User ha la stessa forma indipendentemente dal metodo di autenticazione utilizzato dalla tua app.
Utilizzo dei valori utente con Datastore
L'ID utente è stabile e puoi utilizzarlo in un nome chiave o come proprietà stringa. Pertanto, quando utilizzi i valori utente, devi memorizzare l'ID utente (e magari l'ultimo indirizzo email visualizzato per comunicare con l'utente via email). L'esempio di seguito mostra come confrontare l'utente corrente con un ID utente:
Ti consigliamo vivamente di non memorizzare un UserProperty, perché
include l'indirizzo email insieme all'ID univoco dell'utente. Se un utente cambia
il proprio indirizzo email e tu confronti il vecchio User memorizzato con il nuovo valore User,
non corrisponderanno. Valuta invece la possibilità di utilizzare il User valore dell'ID utente come
identificatore univoco stabile dell'utente.