google.appengine.api.datastore_entities module

Summary

Classes for common kinds, including Contact, Message, and Event.

Most of these kinds are based on the gd namespace “kinds” from GData:

https://developers.google.com/gdata/docs/1.0/elements

Contents

class google.appengine.api.datastore_entities.Contact(title, kind=u'Contact')source

Bases: google.appengine.api.datastore_entities.GdKind

A contact: a person, a venue such as a club or a restaurant, or an organization.

This is the gd Contact kind. See: https://developers.google.com/gdata/docs/1.0/elements#gdContactKind

Most of the information about the contact is in the <gd:contactSection> element; see the reference section for that element for details.

These properties are meaningful. They are all optional.

title string contact’s name content string notes email Email* email address geoPt GeoPt* geographic location im IM* IM address phoneNumber Phonenumber* phone number postalAddress PostalAddress* mailing address link Link* link to more information category Category* tag or label associated with this contact

  • means this property may be repeated.

CONTACT_SECTION_HEADER = u'\n <gd:contactSection>'
CONTACT_SECTION_PROPERTIES = [u'email', u'geoPt', u'im', u'phoneNumber', u'postalAddress']
KIND_PROPERTIES = [u'title', u'content', u'link', u'category']
ToXml()source

Override GdKind.ToXml() to put some properties inside a gd:contactSection.

class google.appengine.api.datastore_entities.Event(title, kind=u'Event')source

Bases: google.appengine.api.datastore_entities.GdKind

A calendar event.

Includes the event title, description, location, organizer, start and end time, and other details.

This is the gd Event kind. See: https://developers.google.com/gdata/docs/1.0/elements#gdEventKind

These properties are meaningful. They are all optional.

title string event name content string event description author string the organizer’s name where string* human-readable location (not a GeoPt) startTime timestamp start time endTime timestamp end time eventStatus string one of the Event.Status values link Link* page with more information category Category* tag or label associated with this event attendee Contact* attendees and other related people

  • means this property may be repeated.

The Contact properties should be Keys of Contact entities. They are represented in the XML encoding as linked <gd:who> elements.

CONTACT_PROPERTIES = [u'attendee']
KIND_PROPERTIES = [u'title', u'content', u'author', u'where', u'startTime', u'endTime', u'eventStatus', u'link', u'category']
class Statussource
CANCELED = u'canceled'
CONFIRMED = u'confirmed'
TENTATIVE = u'tentative'
ToXml()source

Override GdKind.ToXml() to special-case author, gd:where, gd:when, and gd:eventStatus.

class google.appengine.api.datastore_entities.GdKind(kind, title, kind_properties, contact_properties=[])source

Bases: google.appengine.api.datastore.Entity

A base class for gd namespace kinds.

This class contains common logic for all gd namespace kinds. For example, this class translates datastore (app id, kind, key) tuples to tag: URIs appropriate for use in <key> tags.

FOOTER = u'\n</entry>'
HEADER = u"<entry xmlns:gd='http://schemas.google.com/g/2005'>\n <category scheme='http://schemas.google.com/g/2005#kind'\n term='http://schemas.google.com/g/2005#%s' />"
ToXml()source

Returns an XML representation of this entity, as a string.

class google.appengine.api.datastore_entities.Message(title, kind=u'Message')source

Bases: google.appengine.api.datastore_entities.GdKind

A message, such as an email, a discussion group posting, or a comment.

Includes the message title, contents, participants, and other properties.

This is the gd Message kind. See: https://developers.google.com/gdata/docs/1.0/elements#gdMessageKind

These properties are meaningful. They are all optional.

title string message subject content string message body from Contact* sender to Contact* primary recipient cc Contact* CC recipient bcc Contact* BCC recipient reply-to Contact* intended recipient of replies link Link* attachment category Category* tag or label associated with this message geoPt GeoPt* geographic location the message was posted from rating Rating* message rating, as defined by the application

  • means this property may be repeated.

The Contact properties should be Keys of Contact entities. They are represented in the XML encoding as linked <gd:who> elements.

CONTACT_PROPERTIES = [u'from', u'to', u'cc', u'bcc', u'reply-to']
KIND_PROPERTIES = [u'title', u'content', u'link', u'category', u'geoPt', u'rating']