Revision History
The documentation for Google App Engine available on this website is revised regularly. This page describes notable changes made to the documentation.
For information about changes to the App Engine API, the runtime environment, or the SDK, see the release notes.
2009-05-08
- SDK version 1.2.2 for Python now available.
- Python apps and GQL queries in the Admin Console can now retrieve just the keys for entities in query results, instead of full entities.
- A Python datastore model can now specify that a property should not be indexed, regardless of its value. This saves space and write time by turning off the automatic single-property indexes for those properties.
- The Python API for the URL Fetch service can now set a deadline, a maximum amount of time to wait for the remote host to respond.
- Python apps can call a new API to determine how much CPU time has been spent so far during the current request. See Quotas for more information.
- A bulk data downloader has been added to
appcfg.py
, similar to the bulk data uploader.
appcfg.py request_logs
now supports querying logs by the app hostname with the --vhost
option, so you can download logs separately for a Google Apps domain, and appspot.com
test domains.
- The cron schedule syntax has been updated to support "every day 09:00" (equivalent to "every mon,tue,wed,thu,fri,sat,sun 09:00") and "every monday 09:00" (instead of "every monday of month 09:00").
2009-04-22
- SDK version 1.2.1 for Python now available.
- The Users service now provides a unique ID for each user that stays the same even if a user changes her email address. Note that the User object itself still does not yet possess this stability property, so if you need a datastore value to refer to a stable user ID, you must store the unique ID separately.
- The Images service can now produce a composite image from multiple images, and can calculate a color histogram for an image.
- The Memcache service now supports namespaces for keys.
- The bulk data uploader is now an official feature of the
appcfg.py
command in the Python SDK. It now includes the ability to skip a header row in CSV files, and the ability to sign in using a Google Apps domain account. Note: The Loader class API has changed; please update your Loader class files.
- URL Fetch requests can now have custom
User-Agent
and User-Specified
headers.
- Email messages can now have attachments that are
.ics
calendar invitations or .vcf
V-Card contact information cards.
- An App Engine-specific version of the Python PyCrypto cryptography library is now available to Python applications. The documentation has a new page describing the third-party libraries included in the Python runtime environment, with notes about App Engine-specific differences and usage.
2009-04-07
- An "early look" of Google App Engine for Java is now available. You can download the Java SDK, and sign up to try uploading Java apps to App Engine. The documentation includes all new sections on the Java runtime environment and APIs, and the existing documentation has been restructured and extended.
- This release also includes scheduled tasks, aka "cron jobs," for both Java and Python.
- SDK version 1.2.0 for Python and SDK version 1.2.0 for Java are now available.
- Java developers, don't forget to check out the new Google Plugin for Eclipse, with features for both App Engine and Google Web Toolkit.
- Also check out the new Secure Data Connector, which allows you to develop App Engine applications and gadgets for your company's intranet. See the Google Apps developer tools documentation for an overview.
2009-03-17
- Corrected billing FAQ item to indicate that datastore indexes do count against an application's billable storage quota.
2009-03-05
- Minor revision of billing-related text for clarification. What the docs originally called "adjustable" quotas are now known as "billable" quotas.
2009-02-24
- You can now establish a billing account and a daily budget for your application, and allocate additional quotas for CPU, bandwidth, data storage and email messages.
- Updated the Quotas page to include information about billable quotas, the free quota levels, and the per-minute quotas. Also added a notice about an upcoming reduction in the free quota levels.
- Added a page discussing how to purchase additional quota, which includes a walkthrough of how to enable billing for an application, set a daily budget, and check billing status and history.
- Added a new FAQ page for common billing questions.
- Updated the Terms of Service, revising sections 4 and 10 of the terms to include language around payments, fees, and disallowing the use of multiple applications to avoid incurring fees.
2009-02-18
2009-02-04
- SDK version 1.1.9 now available.
- The file size limit has increased from 1 MB to 10 MB. The article on zipimport has been updated with this information. You can now create a simpler zipimport bundle of all of Django 1.0 without having to leave out parts to reduce the archive file size. The app request and response size limit has also increased from 1 MB to 10 MB.
- The datastore now creates single property indexes in both ascending and descending order automatically. Previously, the datastore only made single property indexes in ascending order automatically. Queries that use an index of a single property in descending order no longer require a custom index. If you have such an index, you can remove it from your
index.yaml
and run appcfg.py vacuum_indexes
to delete the extraneous custom indexes. The documentation on indexes has been updated accordingly.
- The Query class now supports the
!=
and IN
operators, similar to the GqlQuery class. The reference has been updated, and an introduction to query filter operators has been added.
- You can now specify the number of times a transaction will be retried in the event of contention using db.run_in_transaction_custom_retries().
- You can now use the Python standard libraries urllib, urllib2 and httplib to access the URL fetch service.
- You can now upload data into the datastore from CSV files on your computer using
appcfg.py
. An experimental and undocumented version of this feature was originally included with the SDK as the "bulk data uploader." A newer, faster implementation of this feature is now provided as the bulkuploader.py
command. The documentation describes this feature in full.
- The
skip_files
property in an app.yaml
file now accepts either a single regular expression, or a list of regular expressions. If a file path matches any of the regular expressions, the file is skipped.
2009-01-15
- SDK version 1.1.8 now available.
- New feature:
PolyModel
and polymorphic queries.
- New feature:
UserProperty
now supports auto_current_user
and auto_current_user_add
attributes.
- New feature: New
ByteString
datastore value type, a short indexed unencoded (non-text) string of bytes. Also, a new ByteStringProperty
class for modeling byte string values.
- New feature: Images API now exposes the current width and height of an image.
- Major re-organization of the docs, primarily to move Python-specific material to its own section in preparation for upcoming support for a second language. External links to old pages on code.google.com will resolve using redirects. (Our apologies to anyone with links to individual pages of the docs hosted elsewhere.) Please file an issue if you find any unresolved broken links or broken pages in the documentation.
2008-11-24
2008-11-20
- SDK version 1.1.6 now available.
- New feature: You can now perform queries, including filters and sort orders, on datastore entity keys, using the special property name
__key__
. See the documentation.
2008-10-28
Model
class constructor now accepts a Key
instance for the parent
argument.
- Added Windows appcfg.py proxy instructions.
- Documented
google.appengine.runtime.DeadlineExceededError
.
- Documented the fact that entities with a property of a common name but with values of mixed types are sorted by types first, then by values as per type. In particular, all integers < all floats.
- Added whole-file example to top of datastore page of the Getting Started Guide.
- Added a note about requiring a space between the name and operator in Query.filter().
- Updated string prefix search tip to use
u'\ufffd'
.
- Documented GQL value literal syntax for dates, keys, users, and GeoPt values.
- Added db.Timeout to list of datastore API exceptions.
- Added note to "Configure an App" about how using HTTPS with the versioned testing URL, such as
https://1.latest.app-id.appspot.com/
, causes browsers to warn about certificates. This is harmless, and users will not see the warning.
- In the article "Using Django 1.0 on App Engine with Zipimport," improved wording about updating existing Django helper projects.
- In the article "Extending Model Properties," fixed several errors in the code samples.
- Mentioned the specific version of Python that App Engine uses: Python 2.5.2.
2008-10-23
2008-10-22
2008-10-16
- Support for handling secure HTTPS connections for
*.appspot.com
domains, with a new handler configuration option.
2008-10-14
- Removed a note from the What Can Be Done In a Transaction section
of the Transactions page about a bug that prevented creating both a
new root entity and descendants of the entity in a single transaction. That
bug was fixed in 1.0.2.
2008-09-30
- SDK version 1.1.5 now available.
- Doc updates for releases 1.1.3 through 1.1.5:
- URL Fetch can be instructed not to follow redirects, using a new parameter.
- URL Fetch is now restricted from fetching the request's own URL, to help prevent infinite loops.
- New Memcache methods:
add_multi()
and replace_multi()
.
ListProperty(str)
gets special treatment as ListProperty(basestring)
because the datastore stores str
values as ASCII-encoded Unicode, and returns such values as unicode
. Previously, this would break ListProperty(str)
models, now they succeed.
StringListProperty
is now a proper class, with additional support for Django forms.
- New article: Using Django 1.0 with App Engine and zipimport
- New version of downloadable docs now available. Includes a fix for an issue with the index.html file and Internet Explorer.
2008-09-26
2008-08-23
2008-08-22
- SDK version 1.1.2 now available.
- Documentation for new features in SDK version 1.1.2:
2008-08-13
- Added section about using GData services in App Engine application.
2008-08-12
- All Google App Engine documentation is now released under a Creative Commons license. Example code in the documentation is released under an Apache license.
- Links outside of the documentation now go directly to the destination, instead of through Google's URL redirect mechanism.
- Anchors in content now use element IDs instead of anchor tags.
2008-07-25
- Documentation for new features in SDK version 1.1.1:
- You can now query and download log data using appcfg.py: appcfg.py request_logs
- The mail service can now use the current user's email address in the "From" field (the sender) of an email message.
- New environment variable: CURRENT_VERSION_ID
- The URL fetch service can now customize the Date HTTP header (was previously disallowed).
- The URL fetch service now uses a default Content-Type header of x-www-form-urlencoded for POST requests (which can be overridden).
- Added section about the new limit on index entries, and how to avoid it; big entities, exploding indexes, and the "Error" index state.
- Documented webapp.util.run_wsgi_app() (previously undocumented), a better way to run WSGI applications in App Engine. Code samples have been updated to recommend run_wsgi_app() over wsgiref as a best practice.
- Revised code samples to instantiate webapp.WSGIApplication outside of the main() routine, a best practice for performance.
- Documented the webapp.util.login_required annotation for webapp get() handler methods (previously undocumented).
- Added documentation for environment variables.
- Added a new section on reserved URLs. In particular, note that
/form
is a reserved URL.
- Added descriptions of how entities without a property are never results for queries the filter or order by that property. Also added a description of how Text and Blob values are never indexed, and so behave like unset properties in queries.
- Added mentions of how str values are stored and returned by the datastore as unicode values, and how this causes ListProperty(str) to not work (because the model tries to validate the value returned by the datastore as a str). (Use ListProperty(basestring) or StringListProperty() instead.)
- Added a description of how two ReferenceProperty model properties to the same kind must have unique collection_name values set to avoid the default collection_names from colliding.
- Added a mention of the Google App Engine Launcher for Mac OS X in the Getting Started Guide.
- Added a description of how responses are compressed automatically (using gzip) if the request headers indicate that the client can accept compressed responses.
2008-07-24
2008-06-27
- Corrected the Model.get_by_id
reference to include method arguments in the method signature. (The arguments were
listed correctly in the method description.)
2008-06-24
- Added more complete documentation for the webapp.Request and webapp.Response classes.
- Added documentation of disallowed HTTP headers for URL Fetch and for responses in general.
- Fixed doc revision history to reflect correct release date for Images and Memcache APIs, and GQL operators.
2008-06-23
2008-05-30
2008-05-28
- Added Image API and Memcache API documentation.
- Updated "Whats is App Engine" document to include Images and Memcache services.
- Added != and IN operators to GQL Documentation.
2008-05-22
- Added a note to the appcfg.py documentation about using the tool behind an HTTP proxy.
- Added clarification of restrictions on datastore entity key names.
- Added clarification of how the 1000-result query limit affects both fetch() and count().
- Added a note about how Python
int
values stored in the datastore are stored and returned as Python long
values.
- Updated the Getting Started example to pass a sequence of up to 10 query results to the template, instead of passing the query object directly. Passing the query object to the template works just fine, but how this works isn't clear from the example. This also more sensibly limits the results to 10, which is what a real app would do anyway.
- Added a note that the application root directory is in the module include path.
- Added an example to the URL Fetch overview illustrating how to submit encoded form data with an HTTP POST action, including correct headers.
- Corrected a statement in the URL Fetch overview: URL fetching does follow HTTP redirects, up to 5 times.
- Corrected a statement about webapp.Response: This class does not inherit from WebOb's Response class, as webapp.Request does. (This may be fixed in a future version.)
- "Groups" in the navigation bar now goes directly to the Google App Engine discussion group. The original "Discussion Groups" page is still available from the sidebar, with a link to the downtime announcement list.
- This documentation revision history page is now available.
2008-05-19
2008-05-15
2008-05-14
- Added note that the server enforces a maximum file size of 1,045,576 bytes.
2008-05-13
2008-05-09
- SDK version 1.0.2 now available.
2008-05-07
2008-05-06
2008-05-01
- Program policies updated to clarify policy on complying with terms of service policies of other Google services, e.g. framing the Google Accounts sign-in screen.
2008-04-30
2008-04-24
2008-04-14
- SDK version 1.0.1 now available.
- Many minor additions and clarifications to the documentation:
- added more information about list property values
- added mention of how model instance attributes that begin with an underscore are not saved with the entity
- added mention that entity key names cannot begin with a number
- added mention that ReferenceProperty back-references lowercase the model name in the default attribute name
- added mention of how to terminate dev_appserver in Windows (Ctrl-Break)
- improved the
tzinfo
example
- mentioned lack of streaming ability in the CGI web server
/appengine/docs/python/runtime.html#App_Caching
moved to /appengine/docs/python/runtime.html#App_Caching
.
2008-04-10
- Program policies updated to clarify a note about putting the Admin Console in a frame.
2008-04-07
- Google App Engine launches. The initial draft of the documentation describes App Engine, the services, the configuration files, the tools, and the Python runtime environment and APIs. The documentation also includes a Getting Started tutorial, a FAQ and a set of articles.
- Google App Engine Campfire One videos added after the Campfire completed.