• Официальный сайт SDK
  • Сайт с примерами кода

Класс User

Экземпляр класса User сопоставляет пользователя с его аккаунтом Google.

Класс User реализован в модуле google.appengine.api.users.

Введение

Экземпляр класса User сопоставляет пользователя с его аккаунтом Google. Приложение может получить доступ к объекту User, который представляет текущего авторизованного пользователя либо вызовом конструктора класса без параметров, либо функции users.get_current_user(). Если текущий пользователь не авторизован, конструктор класса User выдаст исключение UserNotFoundError. (однако выполнение функции users.get_current_user() в таких случах не приводит к выдаче исключений)

Над объектами User можно производить операции сравнения. Если два объекта будут равны, значит они указывают на одного и того же пользователя.

Объект типа User может быть значением свойства модели данных хранилища. Смотрите раздел Классы типов свойств.

Примечание: Пользователь в любой момент может изменить адрес электронной почты в своем аккаунте Google. Смотрите примечание в разделе Объекты User.

Конструктор

class User(email=None)

Сопоставляет пользователя с его аккаунтом Google.

Параметры:

email

Адрес электронной почты заданного пользователя. Если он не указан, будет возвращен объект, относящийся к текущему пользователю (работающим в данный момент с приложением). В том случае, если не был указан адрес и текущий пользователь не авторизовался, выдается исключение UserNotFoundError.

При создании объекта адрес электронной почты не проходит проверку на допустимость значений. Если объект User был создан с указанием адреса электронной почты, не сопоставленного с существующим аккаунтом Google, после сохранения объекта в хранилище он никогда не будет указывать на реальный аккаунт.

Методы экземпляра

Экземпляр класса User имеет следующие доступные методы:

nickname()

Возвращает псевдоним пользователя, являющегося его отображаемым именем. Возможность пользователей изменять свои псевдонимы пока не реализована, но приложение уже сейчас может воспользоваться отображаемым именем и в будущем получить все новые возможности.

Для тех пользователей, которые не указали заданного псевдонима, он будет либо сгенерирован автоматически из левой части адреса электронной почты (если домен почты совпадает с доменом приложения), либо будет содержать значение адреса электронной почты целиком (в противном случае).

email()

Возвращает адрес электронной почты пользователя. Приложения должны использовать метод nickname для вывода имен пользователей.