Вы не должны использовать API низкого уровня напрямую. Он существует для разработчиков фреймворка для создания высокоуровневых библиотек поверх него. Документация предназначена для этих людей (в основном это просто JavaDoc).
Google официально поддерживает каркасы JDO и JPO (которые являются стандартами Java, но не обязательно хорошо подходят для нереляционного хранилища данных (*)), но есть несколько альтернатив "ближе к металлу", которые обещают быть проще для понимания, более легким и быстрым.
См. объективировать , веточку , SimpleDS , а также этот вопрос .
С другой стороны, есть несколько вещей, которые предлагают альтернативные библиотеки. Например, доступ к базовым объектам хранилища данных дает вам двоичные представления, которые вы можете использовать в memcache без сериализации класса. У вас есть детальный доступ к индексированию (вы можете выполнять частичные индексы), и Twig также предоставляет асинхронные запросы, которые могут быть полезны.
(*) У JDO / JPA также есть некоторая отрицательная реакция, поскольку это увеличивает время запуска на несколько секунд, что важно для App Engine, поскольку Google отключает вашу JVM после нескольких минут бездействия, и следующий пользователь будет ждать десять секунд или больше. Тем не менее, я считаю, что это в корне ошибочный аргумент, потому что, когда вы используете Java, вы хотите использовать такие платформы, как JDO или Spring. Google даже так рекламирует. Если эти платформы (особенно те, которые одобрены самим Google) не могут быть разумно использованы в App Engine, то Google должен это исправить, а не авторы платформы.